Shopify MCP Server

MCP Server for Shopify API, enabling interaction with store data through GraphQL API. This server provides tools for managing products, customers, orders, and more.

Features

• Product Management: Search and retrieve product information
• Customer Management: Load customer data and manage customer tags
• Order Management: Advanced order querying and filtering
• GraphQL Integration: Direct integration with Shopify's GraphQL Admin API
• Comprehensive Error Handling: Clear error messages for API and authentication issues

Tools

1. `get-products`

2. `get-products-by-collection`

3. `get-products-by-ids`

4. `get-variants-by-ids`

5. `get-customers`

6. `tag-customer`

7. `get-orders`

8. `get-order`

9. `create-discount`

10. `create-draft-order`

11. `complete-draft-order`

12. `get-collections`

13. `get-shop`

14. `get-shop-details`

15. `manage-webhook`

Setup

Shopify Access Token

To use this MCP server, you'll need to create a custom app in your Shopify store:

1. From your Shopify admin, go to Settings > Apps and sales channels

2. Click Develop apps (you may need to enable developer preview first)

3. Click Create an app

4. Set a name for your app (e.g., "Shopify MCP Server")

5. Click Configure Admin API scopes

6. Select the following scopes:

7. Click Save

8. Click Install app

9. Click Install to give the app access to your store data

10. After installation, you'll see your Admin API access token

11. Copy this token - you'll need it for configuration

Note: Store your access token securely. It provides access to your store data and should never be shared or committed to version control.

More details on how to create a Shopify app can be found here.

Usage with Claude Desktop

Add to your `claude_desktop_config.json`:

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": ["-y", "shopify-mcp-server"],
      "env": {
        "SHOPIFY_ACCESS_TOKEN": "",
        "MYSHOPIFY_DOMAIN": ".myshopify.com"
      }
    }
  }
}

Development

1. Clone the repository

2. Install dependencies:

npm install

3. Create a `.env` file:

SHOPIFY_ACCESS_TOKEN=your_access_token
MYSHOPIFY_DOMAIN=your-store.myshopify.com

4. Build the project:

npm run build

5. Run tests:

npm test

Dependencies

• @modelcontextprotocol/sdk - MCP protocol implementation
• graphql-request - GraphQL client for Shopify API
• zod - Runtime type validation

Contributing

Contributions are welcome! Please read our Contributing Guidelines first.

License

MIT

Community

• MCP GitHub Discussions
• Report Issues

Built with ❤️ using the Model Context Protocol