shopify-store-builder-mcp

MCP server for building Shopify stores with AI. Gives Claude Code, Cursor, and other MCP clients tools to edit themes, pages, and navigation on one Shopify store via the Admin GraphQL API.

Credentials stay on your machine. The server runs locally and talks directly to Shopify.

Demo

https://github.com/user-attachments/assets/afd71d46-e8d7-4c06-96dc-094cae3fe5a2

Quick start

https://github.com/user-attachments/assets/175e5051-b6ec-4201-a33e-d27c68356171

npx -y shopify-store-builder-mcp init

The wizard asks for your store credentials, verifies the connection, and registers the server in the client you pick:

• Claude Code
• Codex CLI
• Gemini CLI
• Claude Desktop
• Cursor
• Windsurf
• VS Code (Copilot)

Pick "Other" to print a config entry for any other MCP client.

Getting Shopify credentials

You need a store on a plan with Admin API access and one of:

Option A: Dev Dashboard app (recommended, tokens auto-refresh)

1. Go to dev.shopify.com/dashboard and create an app for your store.
2. Grant it the scopes: read_themes, write_themes, read_content, write_content, read_online_store_navigation, write_online_store_navigation.
3. Copy the Client ID and Client Secret from the app's settings.

Option B: permanent admin access token

Use an existing shpat_… token from a custom app in your store admin (Settings → Apps and sales channels → Develop apps).

Manual configuration

If you skip the wizard, add this to your MCP client's config:

{
  "shopify-builder": {
    "command": "npx",
    "args": ["-y", "shopify-store-builder-mcp"],
    "env": {
      "SHOPIFY_STORE_DOMAIN": "your-store.myshopify.com",
      "SHOPIFY_CLIENT_ID": "…",
      "SHOPIFY_CLIENT_SECRET": "…"
    }
  }
}

Or with a permanent token, replace the client credentials with "SHOPIFY_ADMIN_ACCESS_TOKEN": "shpat_…".

Tools

| Tool | What it does | |------|--------------| | shop_get_info | Read store name, domain, plan, currency | | theme_list | List installed themes | | theme_read_file | Read a theme file (Liquid, JSON, CSS, JS) | | theme_update_file | Create or update a theme file | | page_list | List store pages | | page_create | Create a page | | page_update | Update a page's title, body, or visibility | | menu_list | List navigation menus | | menu_update | Update a navigation menu |

Development

npm install
npm run dev     # run from source
npm run build   # compile to dist/
npm test

License

ISC