Shopify MCP Server

A Model Context Protocol (MCP) server that connects Claude directly to your Shopify store. Manage products, orders, customers, collections, inventory, and fulfillments — all through natural language.

---

What you can do with this

Once connected, you can talk to your Shopify store like this:

• “Show me all unfulfilled orders from today”
• “Create a new product called Summer T-Shirt, price €29.99, set it to draft”
• “How many active products do we have?”
• “Search for customers with the email [email protected]”
• “Update inventory for product 123 to 50 units”

---

Requirements

• Python 3.11 or higher
• A Shopify store (any plan)
• A Claude.ai Pro, Team, or Enterprise account (for remote MCP connections)

---

Step 1 — Get your Shopify credentials

You need two things: your store name and an Admin API access token.

Find your store name

Your store name is the part before .myshopify.com. Example: if your admin URL is https://acme-store.myshopify.com/admin, your store name is acme-store.

Create a Custom App and get your access token

⚠️ Important: A regular Shopify API key will NOT work. You need an Admin API access token from a Custom App. Follow these steps exactly.

1. Go to Shopify Admin → Settings → Apps and sales channels
2. Click Develop apps in the top right corner
3. If prompted, click Allow custom app development
4. Click Create an app, give it a name (e.g. MCP Server), click Create app
5. Go to the Configuration tab → click Configure Admin API scopes
6. Enable the scopes you need. For full access, select:
   • read_products, write_products
   • read_orders, write_orders
   • read_customers, write_customers
   • read_inventory, write_inventory
   • read_fulfillments, write_fulfillments
   • read_webhooks, write_webhooks
7. Click Save
8. Go to the API credentials tab → click Install app → confirm
9. Click Reveal token once and copy the token immediately — it starts with shpat_

💡 Shopify only shows this token once. If you lose it, go back to API credentials, uninstall the app, then reinstall to generate a new one.

---

Step 2 — Set up the server locally

Clone this repo

git clone https://github.com/daanjonk/shopify-mcp.git
cd shopify-mcp

Install dependencies

pip install -r requirements.txt

Configure your environment variables

cp .env.example .env

Open .env and fill in your values:

SHOPIFY_STORE=your-store-name
SHOPIFY_ACCESS_TOKEN=shpat_xxxxxxxxxxxxxxxxxxxx

Only these two are required. Leave everything else as-is.

Run the server

python server.py

You should see output like:

INFO  Token mode: static SHOPIFY_ACCESS_TOKEN (no auto-refresh)
INFO  Uvicorn running on http://0.0.0.0:8000

Your MCP server is running at http://localhost:8000/mcp.

---