Shopify

v0.2.0API 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

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

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.