cob-shopify-mcp
Shopify store management over MCP or CLI: products, orders, customers, stock, analytics
- 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-mcpAdd 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.comRequiredSHOPIFY_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 secretCOB_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.
