# cob-shopify-mcp

> cob-shopify-mcp is an open-source MCP server for e-commerce. Shopify store management over MCP or CLI: products, orders, customers, stock, analytics. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/callobuzz/cob-shopify-mcp
- **MCP Registry name:** io.github.callobuzz/cob-shopify-mcp
- **Categories:** [e-commerce](https://ai-powered.com/categories/e-commerce)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## 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.

## Alternatives

- [ChatGPT for Amazon](https://ai-powered.com/mcp/chatgpt_for_amazon): ChatGPT for Amazon is a freemium MCP server for marketing.
- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [Ebid](https://ai-powered.com/mcp/ebid): Ebid is a freemium MCP server for e-commerce.
- [Zovo Product Recall Check](https://ai-powered.com/mcp/zovo-product-recall-check): Zovo Product Recall Check is an MCP server for e-commerce.
- [Trackkr MCP Server — Smart Lockerless Parcel Management](https://ai-powered.com/mcp/trackkr-mcp-server-smart-lockerless-parcel-management): Trackkr MCP Server — Smart Lockerless Parcel Management is an MCP server for e-commerce.
- [Skybridge Ecommerce Example](https://ai-powered.com/mcp/skybridge-ecommerce-example): Skybridge Ecommerce Example is an open-source MCP server for e-commerce.
- [GoAI Moat Xiaohongshu Products](https://ai-powered.com/mcp/goai-moat-xiaohongshu-products): GoAI Moat Xiaohongshu Products is an MCP server for e-commerce.
- [GoAI Moat Tiktok Shop](https://ai-powered.com/mcp/goai-moat-tiktok-shop): GoAI Moat Tiktok Shop is an MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/cob-shopify-mcp
