Skip to main content
SH

Shopify

v0.2.1API Key

Global ecommerce platform — dominant DTC backend. Admin REST API v2024-01. Orders, products, customers, inventory, fulfillments, webhooks. Complements Tienda Nube (regional-only) for international DTC brands.

28 tools3 env vars🌐 GLOBALstable on npm

What your agent can do

Shopify gives your agent 28 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.

  • list_ordersList orders with optional filters. Returns an array of order objects with line items, customer, shipping, and financial status.
  • get_orderGet a single order by ID with full detail.
  • create_orderCreate a new order. Useful for draft orders, phone orders, or marketplace order ingestion.
Example call
// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("list_orders", { /* ... */ });

Install

terminal
$ npm install @codespar/mcp-shopify

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json
{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-shopify"
      ],
      "env": {
        "SHOPIFY_SHOP": "<your_shopify_shop>",
        "SHOPIFY_ACCESS_TOKEN": "<your_shopify_access_token>"
      }
    }
  }
}

After restart, your agent can call any of the 28 tools below — try list_orders first.

Environment variables · 3

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

SHOPIFY_SHOP
required

Shopify shop subdomain (e.g. 'acme' for acme.myshopify.com)

SHOPIFY_ACCESS_TOKEN
requiredsecret

Shopify Admin API access token (private/custom app) sent as X-Shopify-Access-Token header

SHOPIFY_API_VERSION
optional

Shopify Admin API version. Defaults to 2024-01.

Available tools · 28

Each tool is independent — your agent loads only what it needs to reduce context and response time.

READlist_orders
List orders with optional filters. Returns an array of order objects with line items, customer, shipping, and financial status.
READget_order
Get a single order by ID with full detail.
WRITEcreate_order
Create a new order. Useful for draft orders, phone orders, or marketplace order ingestion.
WRITEupdate_order
Update an existing order (tags, note, email, shipping_address, metafields, etc).
DELETEcancel_order
Cancel an order. Optionally restock inventory, refund payment, notify customer.
READlist_products
List products with optional filters. Each product includes variants, images, and options.
READget_product
Get a single product by ID including all variants and images.
WRITEcreate_product
Create a new product with variants, options, and images.

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Any MCP clientProtocol

Frequently asked questions

Run `npx -y @codespar/mcp-shopify` and add the config block above to your MCP client — Claude, Cursor, VS Code, or any MCP-compatible client. No build step, no SDK required. Prefer hosted? CodeSpar's managed tier runs it for you with auth handled.
Shopify — MCP server · 28 tools | CodeSpar