Log inSubmit server
Shopbuddy logo

Shopbuddy

Safely edits Shopify themes through staging, validation, visual review, approval, publishing, and rollback.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Shopbuddy

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "shopbuddy-2": {
      "command": "npx",
      "args": [
        "-y",
        "shopbuddy"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y shopbuddy

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 7d ago.

Overview

The shopbuddy MCP server lets AI coding agents modify Shopify themes without editing the live theme directly. It creates an unpublished staging theme, supports file reads, searches, and writes, runs Theme Check, and captures mobile and desktop previews. Store owners review attributed visual changes and approve or roll back updates through one-tap links. Reach for it when theme changes need a controlled review and recovery process.

Use cases

  • Edit a Shopify theme on an unpublished staging copy
  • Validate theme changes with Theme Check
  • Review mobile and desktop screenshots before publishing
  • Request owner approval for an AI-generated theme change
  • Roll back a published theme update

Key features

  • Unpublished staging theme workflow
  • Theme Check validation
  • Mobile and desktop before-and-after screenshots
  • Section-attributed visual change summaries
  • One-tap approval and rollback
  • Hosted MCP endpoint and local CLI

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

5/5 checks healthy over the last 47d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · shopbuddy (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads109Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Shopbuddy works

What shopbuddy MCP server does

The shopbuddy MCP server provides an MCP interface for making controlled changes to Shopify themes. Instead of applying edits directly to the published theme, it starts from a duplicate staging theme and maintains a server-side working copy for the agent. This structure is intended for AI-assisted theme development where owners need to inspect changes before publication.

The repository is a public companion to the hosted Shop Buddy service. It contains the Claude Code plugin and marketplace metadata, the Shop Buddy skill, MCP client configuration, and the MCP Registry manifest. The service itself is hosted, while the local command-line package is distributed through npm.

How it works

A change begins with shopbuddy_start_change, which duplicates the live theme into an unpublished staging theme and retrieves it into the working copy. The agent can then read, search, and write theme files. After editing, shopbuddy_validate runs Theme Check against the changes.

shopbuddy_push_preview uploads the working copy to staging and captures screenshots before and after the change on mobile and desktop. The preview includes a plain-language explanation of what changed, with visual changes attributed to their sections. This gives the store owner both code validation and a visual review step.

The agent can use shopbuddy_submit and shopbuddy_request_publish to provide the owner with a one-tap approval link. Stores may opt into trusted publishing for low-risk changes, but publishing remains logged and can be followed by one-tap rollback through shopbuddy_rollback.

Setup and configuration

The hosted MCP endpoint is https://getshopbuddy.vercel.app/api/mcp. Claude Code can add it as an HTTP MCP server, and Codex can register the same URL. Cursor and VS Code provide install links in the project README. Claude web or desktop and ChatGPT can use the endpoint as a custom connector.

For hosted use, the agent opens a browser so the user can sign in or create an account and approve access.

The shopbuddy MCP server also has a Claude Code plugin installation path. Installing the plugin adds the Shop Buddy skill in addition to the MCP connection. The hosted service is independent and is not affiliated with or endorsed by Shopify.

Tools and capabilities

Documented MCP tools include:

  • shopbuddy_start_change to create a staging copy and working session.
  • shopbuddy_validate to run Theme Check.
  • shopbuddy_push_preview to upload changes and capture comparison screenshots.
  • shopbuddy_submit and shopbuddy_request_publish to route a change for owner approval or publishing.
  • shopbuddy_rollback to roll back a published change.

Together, these tools cover the documented workflow from staging and file edits through validation, visual inspection, approval, publishing, and recovery. The material does not enumerate separate tools for individual file operations; it describes file reading, searching, and writing as agent capabilities within the change workflow.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Shopbuddy

shopbuddy is an MCP server that connects AI coding agents to Shopify theme workflows. Its main tools create staging changes, validate them with Theme Check, push previews with mobile and desktop screenshots, request publication approval, and roll back published changes. The live theme is not edited directly during the documented workflow.

Install it by adding https://getshopbuddy.vercel.app/api/mcp as an HTTP MCP server, using the provided Cursor or VS Code install links, or running npx shopbuddy for local mode. Claude Code and Codex have documented command-line registration options.

Yes, shopbuddy provides a Cursor install link in the repository README. The link configures the hosted MCP endpoint, after which the agent opens a browser for sign-in or account creation and access approval.

No, the hosted setup does not require API keys. The agent opens a browser where you sign in or create an account and click Allow.

Related MCP servers

All in E-Commerce All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewShopbuddy AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/shopbuddy-2?style=directory)](https://allmcps.com/mcp/shopbuddy-2)
HTML Embed
<a href="https://allmcps.com/mcp/shopbuddy-2"><img src="https://allmcps.com/api/badge/shopbuddy-2?style=directory" alt="Shopbuddy on AllMCPs" /></a>