Enables AI agents to safely edit Shopify themes using staging environments, automated validation, visual reviews, and one-tap rollbacks.
Also known as tmill313/shopbuddy-plugin, shopbuddy-plugin
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.3.1
- Last commit
- Sep 2, 2026
- License
- MIT
What is Shop Buddy MCP?
Shop Buddy enables AI agents to safely edit Shopify themes using staging environments, automated validation, visual reviews, and one-tap rollbacks.
Summary generated from the project's README
About Shop Buddy MCP server
Shop Buddy provides a safety layer for AI coding agents that need to modify Shopify themes. Instead of editing live storefronts directly, the server duplicates the current theme into an unpublished staging environment. This allows an agent to perform file operations and run Theme Check via the shopbuddy_validate tool to ensure code quality before any changes are visible to customers.
Developers can connect this service to Claude or ChatGPT by adding a custom connector using the provided API URL. The setup process involves signing in through a browser to authorize the connection without needing manual API keys. For local development, the shopbuddy CLI can be run via npx without an account. The system includes visual verification by capturing desktop and mobile screenshots through shopbuddy_push_preview, allowing users to review changes before using shopbuddy_submit to request a final publication.
What you can do with it
- 1Safe theme experimentationAsk an AI agent to test a new layout design on a duplicate staging theme instead of the live site.
- 2Automated code validationInstruct the agent to check the theme for errors using the built-in validation tool.
- 3Visual change verificationRequest screenshots of the mobile and desktop versions of the site to see how code edits look visually.
- 4Instant error recoveryRevert the Shopify theme to its previous state immediately if a change causes issues.
Written from the project's README. Every use case is checked against a quote from it.
How to install Shop Buddy MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Shop Buddy MCP in Claude Code
$ claude mcp add --env 'SHOPBUDDY_API_KEY=<YOUR_SHOPBUDDY_API_KEY>' shopbuddy-plugin -- npx -y shopbuddyInstall Shop Buddy MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"shopbuddy-plugin": {
"command": "npx",
"args": [
"-y",
"shopbuddy"
],
"env": {
"SHOPBUDDY_API_KEY": "<YOUR_SHOPBUDDY_API_KEY>"
}
}
}
}Install Shop Buddy MCP in VS Code
.vscode/mcp.json
{
"servers": {
"shopbuddy-plugin": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"shopbuddy"
],
"env": {
"SHOPBUDDY_API_KEY": "<YOUR_SHOPBUDDY_API_KEY>"
}
}
}
}Install Shop Buddy MCP in VS Code CLI
$ code --add-mcp '{"name":"shopbuddy-plugin","type":"stdio","command":"npx","args":["-y","shopbuddy"],"env":{"SHOPBUDDY_API_KEY":"<YOUR_SHOPBUDDY_API_KEY>"}}'Install Shop Buddy MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"shopbuddy-plugin": {
"command": "npx",
"args": [
"-y",
"shopbuddy"
],
"env": {
"SHOPBUDDY_API_KEY": "<YOUR_SHOPBUDDY_API_KEY>"
}
}
}
}Install Shop Buddy MCP in Codex
$ codex mcp add shopbuddy-plugin --env 'SHOPBUDDY_API_KEY=<YOUR_SHOPBUDDY_API_KEY>' -- npx -y shopbuddyInstall Shop Buddy MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.shopbuddy-plugin] command = "npx" args = ["-y", "shopbuddy"] [mcp_servers.shopbuddy-plugin.env] SHOPBUDDY_API_KEY = "<YOUR_SHOPBUDDY_API_KEY>"
Install Shop Buddy MCP in Gemini CLI
$ gemini mcp add -s user -e 'SHOPBUDDY_API_KEY=<YOUR_SHOPBUDDY_API_KEY>' shopbuddy-plugin npx -- -y shopbuddyInstall Shop Buddy MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"shopbuddy-plugin": {
"command": "npx",
"args": [
"-y",
"shopbuddy"
],
"env": {
"SHOPBUDDY_API_KEY": "<YOUR_SHOPBUDDY_API_KEY>"
}
}
}
}Configuration
SHOPBUDDY_API_KEYSecretAPI key from the platform's Install page
SHOPBUDDY_API_URLPlatform URL
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachabletmill313/shopbuddy-plugin is public and reachablegithub.com/tmill313/shopbuddy-plugin ↗Pass
- Package names this repository as its sourceshopbuddy names git+https://github.com/tmill313/shopbuddy.git as its sourcenpmjs.com/package/shopbuddy ↗Finding
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-02github.com/tmill313/shopbuddy-plugin ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from shopbuddyPass
- No critical advisory in the package or its dependencies147 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubShop Buddy
Let your AI coding agent change your Shopify theme safely. Every edit lands on an unpublished staging theme. Shop Buddy validates it with Theme Check, screenshots before/after on mobile and desktop with a plain-language summary of what changed, and you approve with one tap. Rollback is one tap. The live theme is never edited directly.
Site and one-click install: https://getshopbuddy.vercel.app/install
# Claude Code (hosted MCP, signs in through your browser)
claude mcp add --transport http shopbuddy https://getshopbuddy.vercel.app/api/mcp
# Claude Code plugin (adds the skill too)
claude plugin marketplace add tmill313/shopbuddy-plugin
claude plugin install shopbuddy@shopbuddy-marketplace
# Codex
codex mcp add shopbuddy --url https://getshopbuddy.vercel.app/api/mcp
# Local CLI (no account needed for local mode)
npx shopbuddy
Claude (web/desktop) and ChatGPT: add a custom connector with https://getshopbuddy.vercel.app/api/mcp. The agent opens a browser tab; sign in or create an account there and click Allow. No keys.
How it works
shopbuddy_start_changeduplicates the live theme into a staging theme and pulls it into a server-side working copy.- The agent reads, searches and writes files, runs Theme Check with
shopbuddy_validate, thenshopbuddy_push_previewuploads to staging and captures before/after screenshots, each visual change attributed to its section. shopbuddy_submitandshopbuddy_request_publishhand the store owner a one-tap approval link. Owners can opt a store into trusted publishing so low-risk changes publish on request, always logged and one tap fromshopbuddy_rollback.
Agent-readable summary: https://getshopbuddy.vercel.app/llms.txt
What is in this repo
This is the public companion to the hosted service: the Claude Code plugin and marketplace manifests, the shopbuddy skill, the MCP client config, and the MCP Registry manifest (io.github.tmill313/shopbuddy). The platform itself is a hosted service; the CLI ships compiled on npm as shopbuddy.
Privacy and terms
https://getshopbuddy.vercel.app/privacy · https://getshopbuddy.vercel.app/terms
Shop Buddy is an independent service, not affiliated with or endorsed by Shopify.
Shop Buddy MCP questions
How do I add Shop Buddy MCP to Claude Code?
Run claude mcp add --env 'SHOPBUDDY_API_KEY=<YOUR_SHOPBUDDY_API_KEY>' shopbuddy-plugin -- npx -y shopbuddy in your terminal. Add --scope user to make it available in every project.
How do I add Shop Buddy MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How does Shop Buddy ensure theme changes are safe?
It duplicates the live theme into an unpublished staging theme and uses Theme Check for validation before any changes are applied.
Can I undo a change made by the AI?
Yes, you can revert changes with a single tap using the rollback feature.
How do I review the visual impact of changes?
The tool captures before and after screenshots on both mobile and desktop, providing a plain-language summary of the changes.
Does the AI edit my live Shopify theme directly?
No, the live theme is never modified directly; all work happens on a staging theme first.