Skip to content
MCP server

cob-shopify-mcp

Shopify store management over MCP or CLI: products, orders, customers, stock, analytics

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.12.1
Listing updated
today

Similar MCP servers

About cob-shopify-mcp

cob-shopify-mcp is an open-source MCP server for e-commerce. It runs locally on your machine and is started by your AI client.

cob-shopify-mcp exposes a Shopify store as 62 built-in tools across five areas: products (15), orders (15), customers (9), inventory (7) and ShopifyQL-powered analytics (16). The same tools work as a standalone command-line program, for example cob-shopify products list --limit 5, and as an MCP server for Claude, Cursor or Windsurf.

To keep a model's context small, an advertise-and-activate mode loads one meta-tool and brings domains in on demand; the README claims 82% less context. Setting COB_SHOPIFY_READ_ONLY=true offers only tools that read. Responses include Shopify API cost metadata, rate limiting follows Shopify's cost-based throttling, and queries can be cached.

Auth can be a static Admin API token or OAuth client credentials. Custom tools can be defined in YAML against the Admin GraphQL API or the Storefront API, with a Storefront token minted from Admin credentials. It also ships four MCP resources and four prompts, such as a sales report and inventory risk.

Install

Run in a terminal

claude mcp add cob-shopify-mcp --env SHOPIFY_STORE_DOMAIN='<SHOPIFY_STORE_DOMAIN>' --env SHOPIFY_CLIENT_SECRET='<SHOPIFY_CLIENT_SECRET>' --env SHOPIFY_ACCESS_TOKEN='<SHOPIFY_ACCESS_TOKEN>' -- npx -y cob-shopify-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "cob-shopify-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cob-shopify-mcp"
      ],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "<SHOPIFY_STORE_DOMAIN>",
        "SHOPIFY_CLIENT_SECRET": "<SHOPIFY_CLIENT_SECRET>",
        "SHOPIFY_ACCESS_TOKEN": "<SHOPIFY_ACCESS_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cob-shopify-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cob-shopify-mcp"
      ],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "<SHOPIFY_STORE_DOMAIN>",
        "SHOPIFY_CLIENT_SECRET": "<SHOPIFY_CLIENT_SECRET>",
        "SHOPIFY_ACCESS_TOKEN": "<SHOPIFY_ACCESS_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "cob-shopify-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "cob-shopify-mcp"
      ],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "<SHOPIFY_STORE_DOMAIN>",
        "SHOPIFY_CLIENT_SECRET": "<SHOPIFY_CLIENT_SECRET>",
        "SHOPIFY_ACCESS_TOKEN": "<SHOPIFY_ACCESS_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "cob-shopify-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cob-shopify-mcp"
      ],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "<SHOPIFY_STORE_DOMAIN>",
        "SHOPIFY_CLIENT_SECRET": "<SHOPIFY_CLIENT_SECRET>",
        "SHOPIFY_ACCESS_TOKEN": "<SHOPIFY_ACCESS_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "cob-shopify-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cob-shopify-mcp"
      ],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "<SHOPIFY_STORE_DOMAIN>",
        "SHOPIFY_CLIENT_SECRET": "<SHOPIFY_CLIENT_SECRET>",
        "SHOPIFY_ACCESS_TOKEN": "<SHOPIFY_ACCESS_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • SHOPIFY_STORE_DOMAINYour store's address, for example your-store.myshopify.comRequired
  • SHOPIFY_CLIENT_IDClient ID of your Shopify app (with SHOPIFY_CLIENT_SECRET)
  • SHOPIFY_CLIENT_SECRETClient secret of your Shopify app (shpss_...)
  • SHOPIFY_ACCESS_TOKENAdmin API access token (shpat_...); used instead of the client ID and secret
  • COB_SHOPIFY_READ_ONLYtrue to offer only the tools that read

What it does

62 built-in tools
Products, orders, customers, inventory and analytics.
ShopifyQL analytics
Sales summaries, cohorts and period comparisons in single calls.
CLI and MCP
One engine with terminal commands and an MCP server.
Advertise and activate
Loads one meta-tool and activates domains on demand.
Read-only switch
Environment variable limits it to read tools.
Custom YAML tools
Define extra tools on Admin or Storefront GraphQL.

Good for

  • Ask for last week's sales compared with the previous period
  • Check which products are at inventory risk
  • Look up an order or customer from chat
  • Script store reports from a terminal or CI

Pricing

Open source

More servers for the same service

cob-shopify-mcp FAQ

Can it be read-only?

Yes, set COB_SHOPIFY_READ_ONLY=true.

How does it authenticate?

With an Admin API token, or OAuth client credentials.

Does it work without MCP?

Yes, as a standalone CLI.

Which transports exist?

stdio and Streamable HTTP.

Is cob-shopify-mcp free?

Yes. cob-shopify-mcp is open source, so you can use and self-host it for free.

How do I add cob-shopify-mcp to Claude Code?

Run this command in your terminal: claude mcp add cob-shopify-mcp --env SHOPIFY_STORE_DOMAIN='<SHOPIFY_STORE_DOMAIN>' --env SHOPIFY_CLIENT_SECRET='<SHOPIFY_CLIENT_SECRET>' --env SHOPIFY_ACCESS_TOKEN='<SHOPIFY_ACCESS_TOKEN>' -- npx -y cob-shopify-mcp

What are the best alternatives to cob-shopify-mcp?

The closest alternatives to cob-shopify-mcp are ChatGPT for Amazon, O'So MCP Server for PrestaShop, Ebid, Zovo Product Recall Check and Trackkr MCP Server — Smart Lockerless Parcel Management.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers