shopify-mcp-extended

v2.0.1

Published

a month ago

MCP Server for the Shopify Admin GraphQL API. Extended fork of shopify-mcp adding draft order tools with the full quote/discount breakdown, plus metaobject and metafield definition tools.

0High
0Medium
0Low

okitoxo

shopify mcp model-context-protocol graphql ai llm claude

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.

📦 Package Name: shopify-mcp-extended 🚀 Command: shopify-mcp-extended

Fork of GeLi2001/shopify-mcp (MIT), adding draft order read/write (with the complete quote and discount breakdown), metaobject, and metafield definition tools. Published under its own name — the upstream package is unaffected.
Previously published as @okitoxo/shopify-mcp (v1.x). Renamed as of v2.0.0; update your MCP config to npx shopify-mcp-extended.
v2.0.1 fixes startup under mcpo (AssertionError: Custom field not found). Every tool now emits a fully self-contained JSON Schema with no $ref. See CHANGELOG.md.

Features

Product Management: Full CRUD for products, variants, and options (8 tools)
Customer Management: Full CRUD, merge, and address management (8 tools)
Order Management: Smart lookup, cancel, close/open, mark as paid, fulfillment, refunds (9 tools)
Draft Order Management: Full CRUD plus completion, for phone/chat sales, invoicing, and wholesale (6 tools)
Metafield Management: Get, set, and delete metafields on any resource, plus full definition management (6 tools)
Metaobject Management: Discover definitions and full CRUD for metaobject entries (6 tools)
Inventory Management: Set absolute inventory quantities at locations (1 tool)
Tag Management: Add/remove tags on any taggable resource (1 tool)
Pagination & Sorting: Cursor-based pagination and sort keys on all list queries
Advanced Filtering: Pass-through Shopify query syntax for all list endpoints
GraphQL Integration: Direct integration with Shopify's GraphQL Admin API (2026-01)
Comprehensive Error Handling: Clear error messages for API and authentication issues

Prerequisites

Node.js (version 18 or higher)
A Shopify store with a custom app (see setup instructions below)

Setup

Authentication

This server supports two authentication methods:

Option 1: Client Credentials (Dev Dashboard apps, January 2026+)

As of January 1, 2026, new Shopify apps are created in the Dev Dashboard and use OAuth client credentials instead of static access tokens.

From your Shopify admin, go to Settings > Apps and sales channels
Click Develop apps > Build app in dev dashboard
Create a new app and configure Admin API scopes:
- read_products, write_products
- read_customers, write_customers
- read_orders, write_orders
- read_draft_orders, write_draft_orders
- read_quick_sale, write_quick_sale (also required by the draft order operations)
- read_metaobjects, write_metaobjects
- read_metaobject_definitions, write_metaobject_definitions
- read_payment_terms (optional, only for get-draft-order-by-id with includePaymentTerms: true)
Install the app on your store
Copy your Client ID and Client Secret from the app's API credentials

The server will automatically exchange these for an access token and refresh it before it expires (tokens are valid for ~24 hours).

Option 2: Static Access Token (legacy apps)

If you have an existing custom app with a static shpat_ access token, you can still use it directly.

Usage with Claude Desktop

Client Credentials (recommended):

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": [
        "shopify-mcp-extended",
        "--clientId",
        "<YOUR_CLIENT_ID>",
        "--clientSecret",
        "<YOUR_CLIENT_SECRET>",
        "--domain",
        "<YOUR_SHOP>.myshopify.com"
      ]
    }
  }
}

Static Access Token (legacy):

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": [
        "shopify-mcp-extended",
        "--accessToken",
        "<YOUR_ACCESS_TOKEN>",
        "--domain",
        "<YOUR_SHOP>.myshopify.com"
      ]
    }
  }
}

Locations for the Claude Desktop config file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

Usage with Claude Code

Client Credentials:

claude mcp add shopify -- npx shopify-mcp-extended \
  --clientId YOUR_CLIENT_ID \
  --clientSecret YOUR_CLIENT_SECRET \
  --domain your-store.myshopify.com

Static Access Token (legacy):

claude mcp add shopify -- npx shopify-mcp-extended \
  --accessToken YOUR_ACCESS_TOKEN \
  --domain your-store.myshopify.com

Alternative: Run Locally with Environment Variables

If you prefer to use environment variables instead of command-line arguments:

Create a .env file with your Shopify credentials:

Client Credentials:

SHOPIFY_CLIENT_ID=your_client_id
SHOPIFY_CLIENT_SECRET=your_client_secret
MYSHOPIFY_DOMAIN=your-store.myshopify.com

Static Access Token (legacy):

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

Run the server with npx:
```
npx shopify-mcp-extended
```

Direct Installation (Optional)

If you want to install the package globally:

npm install -g shopify-mcp-extended

Then run it:

shopify-mcp-extended --clientId=<ID> --clientSecret=<SECRET> --domain=<YOUR_SHOP>.myshopify.com

Additional Options

--apiVersion: Specify the Shopify API version (default: 2026-01). Can also be set via SHOPIFY_API_VERSION environment variable.

⚠️ Important: If you see errors about "SHOPIFY_ACCESS_TOKEN environment variable is required" when using command-line arguments, you might have a different package installed. Make sure you're using shopify-mcp-extended, not shopify-mcp or shopify-mcp-server.

Available Tools (57)

Pagination, Sorting & Filtering

All list query tools (get-products, get-customers, get-orders, get-customer-orders) support:

Cursor-based pagination: after / before (cursor strings), with pageInfo in the response (hasNextPage, hasPreviousPage, startCursor, endCursor)
Sorting: sortKey (enum specific to each resource) and reverse (boolean)
Advanced filtering: query or searchQuery parameter accepting Shopify query syntax

Product Management (8 tools)

get-products
- Get all products or search by title with pagination and sorting
- Inputs:
  - searchTitle (string, optional): Filter products by title (wraps in title:*...*)
  - limit (number, default: 10): Maximum number of products to return
  - query (string, optional): Raw Shopify query string (e.g. "status:active vendor:Nike tag:sale")
  - sortKey (string, optional): One of CREATED_AT, ID, INVENTORY_TOTAL, PRODUCT_TYPE, PUBLISHED_AT, RELEVANCE, TITLE, UPDATED_AT, VENDOR
  - reverse (boolean, optional): Reverse the sort order
  - after / before (string, optional): Pagination cursors
get-product-by-id
- Get a specific product by ID with full details including SEO, options, media, variants, and collections
- Inputs:
  - productId (string, required): Shopify product GID
- Returns: productType, descriptionHtml, seo, options (with optionValues), media (images), variants, collections, tags, vendor, price range, inventory
create-product
- Create a new product. When using productOptions, Shopify registers all option values but only creates one default variant (first value of each option, price $0). Use manage-product-variants with strategy: REMOVE_STANDALONE_VARIANT afterward to create all real variants with prices.
- Inputs:
  - title (string, required): Title of the product
  - descriptionHtml (string, optional): Description with HTML
  - handle (string, optional): URL slug. Auto-generated from title if omitted
  - vendor (string, optional): Vendor of the product
  - productType (string, optional): Type of the product
  - tags (array of strings, optional): Product tags
  - status (string, optional): "ACTIVE", "DRAFT", or "ARCHIVED". Default "DRAFT"
  - seo (object, optional): { title, description } for search engines
  - metafields (array of objects, optional): Custom metafields (namespace, key, value, type)
  - productOptions (array of objects, optional): Options to create inline, e.g. [{ name: "Size", values: [{ name: "S" }, { name: "M" }] }]. Max 3 options.
  - collectionsToJoin (array of strings, optional): Collection GIDs to add the product to
update-product
- Update an existing product's fields
- Inputs:
  - id (string, required): Shopify product GID
  - title (string, optional): New title
  - descriptionHtml (string, optional): New description
  - handle (string, optional): New URL slug
  - vendor (string, optional): New vendor
  - productType (string, optional): New product type
  - tags (array of strings, optional): New tags (overwrites existing)
  - status (string, optional): "ACTIVE", "DRAFT", or "ARCHIVED"
  - seo (object, optional): { title, description } for search engines
  - metafields (array of objects, optional): Metafields to set or update
  - collectionsToJoin (array of strings, optional): Collection GIDs to add the product to
  - collectionsToLeave (array of strings, optional): Collection GIDs to remove the product from
  - redirectNewHandle (boolean, optional): If true, old handle redirects to new handle
delete-product
- Delete a product
- Inputs:
  - id (string, required): Shopify product GID
manage-product-options
- Create, update, or delete product options (e.g. Size, Color)
- Inputs:
  - productId (string, required): Shopify product GID
  - action (string, required): "create", "update", or "delete"
  - variantStrategy (string, optional): "LEAVE_AS_IS" (default) or "CREATE" — controls whether new variant combinations are generated when adding options
  - For action: "create":
    - options (array, required): Options to create, e.g. [{ name: "Size", values: ["S", "M", "L"] }]
  - For action: "update":
    - optionId (string, required): Option GID to update
    - name (string, optional): New name for the option
    - position (number, optional): New position
    - valuesToAdd (array of strings, optional): Values to add
    - valuesToDelete (array of strings, optional): Value GIDs to remove
  - For action: "delete":
    - optionIds (array of strings, required): Option GIDs to delete
manage-product-variants
- Create or update product variants in bulk
- Inputs:
  - productId (string, required): Shopify product GID
  - strategy (string, optional): How to handle the default variant when creating. "DEFAULT" (removes "Default Title" automatically), "REMOVE_STANDALONE_VARIANT" (recommended for full control), or "PRESERVE_STANDALONE_VARIANT"
  - variants (array, required): Variants to create or update. Each variant:
    - id (string, optional): Variant GID for updates. Omit to create new
    - price (string, optional): Price, e.g. "49.00"
    - compareAtPrice (string, optional): Compare-at price for showing discounts
    - sku (string, optional): SKU (mapped to inventoryItem.sku)
    - tracked (boolean, optional): Whether inventory is tracked. Set false for print-on-demand
    - taxable (boolean, optional): Whether the variant is taxable
    - barcode (string, optional): Barcode
    - weight (number, optional): Weight of the variant
    - weightUnit (string, optional): "GRAMS", "KILOGRAMS", "OUNCES", or "POUNDS"
    - optionValues (array, optional): Option values, e.g. [{ optionName: "Size", name: "A4" }]
delete-product-variants
- Delete one or more variants from a product
- Inputs:
  - productId (string, required): Shopify product GID
  - variantIds (array of strings, required): Variant GIDs to delete

Customer Management (8 tools)

get-customers
- List customers with search, pagination, and sorting
- Inputs:
  - searchQuery (string, optional): Freetext or Shopify query syntax (e.g. "country:US tag:vip orders_count:>5")
  - limit (number, default: 10): Maximum number of customers to return
  - sortKey (string, optional): One of CREATED_AT, ID, LAST_UPDATE, LOCATION, NAME, ORDERS_COUNT, RELEVANCE, TOTAL_SPENT, UPDATED_AT
  - reverse (boolean, optional): Reverse the sort order
  - after / before (string, optional): Pagination cursors
get-customer-by-id
- Get a single customer by ID with full details
- Inputs:
  - id (string, required): Shopify customer ID (numeric only, e.g. "6276879810626")
- Returns: name, email, phone, addresses, tags, note, tax status, amount spent, order count, metafields
create-customer
- Create a new customer
- Inputs:
  - firstName (string, optional): Customer's first name
  - lastName (string, optional): Customer's last name
  - email (string, optional): Customer's email address
  - phone (string, optional): Customer's phone number
  - tags (array of strings, optional): Tags to apply
  - note (string, optional): Note about the customer
  - taxExempt (boolean, optional): Whether the customer is exempt from taxes
  - metafields (array of objects, optional): Custom metafields (namespace, key, value, type)
  - addresses (array of objects, optional): Customer addresses (address1, address2, city, provinceCode, zip, country, phone)
update-customer
- Update a customer's information
- Inputs:
  - id (string, required): Shopify customer ID (numeric only, e.g. "6276879810626")
  - firstName (string, optional): Customer's first name
  - lastName (string, optional): Customer's last name
  - email (string, optional): Customer's email address
  - phone (string, optional): Customer's phone number
  - tags (array of strings, optional): Tags to apply to the customer
  - note (string, optional): Note about the customer
  - taxExempt (boolean, optional): Whether the customer is exempt from taxes
  - emailMarketingConsent (object, optional): Email marketing consent settings
    - marketingState (string, required): "NOT_SUBSCRIBED", "SUBSCRIBED", "UNSUBSCRIBED", or "PENDING"
    - consentUpdatedAt (string, optional): ISO 8601 timestamp
    - marketingOptInLevel (string, optional): "SINGLE_OPT_IN", "CONFIRMED_OPT_IN", or "UNKNOWN"
  - metafields (array of objects, optional): Customer metafields
delete-customer
- Delete a customer
- Inputs:
  - id (string, required): Shopify customer ID (numeric only, e.g. "6276879810626")
customer-merge
- Merge two customer records into one
- Inputs:
  - customerOneId (string, required): GID of the first customer
  - customerTwoId (string, required): GID of the second customer
  - overrideFields (object, optional): Override which fields to keep from which customer (firstName, lastName, email, phone, defaultAddress, note, tags)
manage-customer-address
- Create, update, or delete a customer's mailing address
- Inputs:
  - customerId (string, required): Customer GID
  - action (string, required): "create", "update", or "delete"
  - addressId (string, optional): Address GID (required for update/delete)
  - address (object, optional): Address fields (required for create/update): address1, address2, city, company, countryCode, firstName, lastName, phone, provinceCode, zip
  - setAsDefault (boolean, optional): Set as customer's default address

Order Management (9 tools)

get-orders
- Get orders with filtering, pagination, and sorting
- Inputs:
  - status (string, optional): "any", "open", "closed", or "cancelled". Default "any"
  - limit (number, default: 10): Maximum number of orders to return
  - query (string, optional): Raw Shopify query string (e.g. "financial_status:paid fulfillment_status:shipped tag:rush")
  - sortKey (string, optional): One of CREATED_AT, ORDER_NUMBER, TOTAL_PRICE, FINANCIAL_STATUS, FULFILLMENT_STATUS, UPDATED_AT, CUSTOMER_NAME, PROCESSED_AT, ID, RELEVANCE
  - reverse (boolean, optional): Reverse the sort order
  - after / before (string, optional): Pagination cursors
get-order-by-id
- Get a specific order by ID with smart lookup — accepts order name (#77235 or 77235), numeric ID (8054938337547), or full GID (gid://shopify/Order/...)
- Inputs:
  - orderId (string, required): Order name, numeric ID, or full GID
- Returns: pricing, customer, shipping/billing addresses, line items, tags, notes, metafields, cancel reason, return status, discount codes, PO number, timestamps
update-order
- Update an existing order
- Inputs:
  - id (string, required): Shopify order GID
  - tags (array of strings, optional): New tags for the order
  - email (string, optional): Update customer email on the order
  - note (string, optional): Order notes
  - phone (string, optional): Phone number for the order
  - poNumber (string, optional): Purchase order number
  - customAttributes (array of objects, optional): Custom key-value attributes
  - metafields (array of objects, optional): Order metafields
  - shippingAddress (object, optional): Shipping address fields
get-customer-orders
- Get orders for a specific customer with pagination and sorting
- Inputs:
  - customerId (string, required): Shopify customer ID (numeric only, e.g. "6276879810626")
  - limit (number, default: 10): Maximum number of orders to return
  - sortKey (string, optional): Same sort keys as get-orders
  - reverse (boolean, optional): Reverse the sort order
  - after / before (string, optional): Pagination cursors
order-cancel
- Cancel an order with options for refunding, restocking, and customer notification. Irreversible.
- Inputs:
  - orderId (string, required): Order GID
  - reason (string, required): "CUSTOMER", "DECLINED", "FRAUD", "INVENTORY", "OTHER", or "STAFF"
  - restock (boolean, required): Whether to restock inventory
  - notifyCustomer (boolean, default: false): Notify the customer
  - staffNote (string, optional): Internal note
  - refund (boolean, optional): Refund to original payment method
order-close-open
- Close or reopen an order
- Inputs:
  - orderId (string, required): Order GID
  - action (string, required): "close" or "open"
order-mark-as-paid
- Mark an order as paid (for manual/offline payments)
- Inputs:
  - orderId (string, required): Order GID
create-fulfillment
- Create a fulfillment (mark items as shipped) with optional tracking
- Inputs:
  - lineItemsByFulfillmentOrder (array, required): Fulfillment orders and line items to fulfill
  - trackingInfo (object, optional): { number, url, company } tracking details
  - notifyCustomer (boolean, default: false): Send shipping notification
refund-create
- Create a full or partial refund with optional restocking
- Inputs:
  - orderId (string, required): Order GID
  - refundLineItems (array, optional): Line items to refund with lineItemId, quantity, restockType (CANCEL/RETURN/NO_RESTOCK), locationId
  - shipping (object, optional): { amount, fullRefund } shipping refund
  - note (string, optional): Refund note
  - notify (boolean, optional): Send refund notification

Draft Order Management (6 tools)

All draft order reads and writes return the full quote breakdown, so a draft order can be reviewed exactly as the customer sees it:

Line items: originalUnitPrice, originalTotal, discountedUnitPrice, discountedTotal, totalDiscount, per-line appliedDiscount (title, value, valueType, amount), taxLines, sku, vendor, variantTitle, custom, taxable, requiresShipping, customAttributes
Discounts: order-level appliedDiscount, discountCodes, acceptAutomaticDiscounts, and platformDiscounts (automatic/code discounts with title, code, summary, presentationLevel, discountClasses, automaticDiscount, bxgyDiscount, totalAmount)
Totals: totalLineItemsPrice, lineItemsSubtotalPrice, subtotalPrice, totalDiscounts, totalShippingPrice, totalTax, totalPrice, totalQuantityOfLineItems, totalWeight
Shipping & tax: shippingLine (title, originalPrice, discountedPrice), taxLines, taxesIncluded, taxExempt
Context: currencyCode, presentmentCurrencyCode, status, ready, invoiceUrl, invoiceSentAt, poNumber, email, phone, customer, shippingAddress, billingAddress, customAttributes, tags, note, and order (the order created on completion)

Money values are returned in shop currency. When presentmentCurrencyCode differs from currencyCode, the customer is charged in the presentment currency and these amounts are the shop-currency estimate.

get-draft-orders
- Get draft orders with filtering, pagination, and sorting
- Inputs:
  - status (string, optional): "any", "open", "invoice_sent", or "completed". Default "any"
  - limit (number, default: 10): Maximum number of draft orders to return
  - query (string, optional): Raw Shopify query string
  - sortKey (string, optional): One of CUSTOMER_NAME, ID, NUMBER, RELEVANCE, STATUS, TOTAL_PRICE, UPDATED_AT
  - reverse (boolean, optional): Reverse the sort order
  - after / before (string, optional): Pagination cursors
get-draft-order-by-id
- Get a single draft order by GID
- Inputs:
  - draftOrderId (string, required): Draft order GID
  - lineItemLimit (number, default: 50): Maximum number of line items to return (max 250)
  - includePaymentTerms (boolean, default: false): Also return payment terms (name, type, dueInDays, overdue). Requires the extra read_payment_terms access scope — the request fails if the app doesn't have it
create-draft-order
- Create a draft order for phone/chat sales, invoicing, or wholesale
- Inputs:
  - lineItems (array, required): Product variants (variantId) or custom items (title + price). Max 499
  - customerId (string, optional): Customer GID
  - email, phone, note, tags, poNumber (optional)
  - shippingAddress, billingAddress (objects, optional)
  - appliedDiscount (object, optional): { title, value, valueType } order-level discount
update-draft-order
- Update an existing draft order. Updating a draft order unlinks any checkout already started for it
- Inputs:
  - draftOrderId (string, required): Draft order GID
  - lineItems (array, optional): Replaces the full set of line items when provided
  - Remaining inputs match create-draft-order (customerId, email, phone, note, tags, poNumber, shippingAddress, billingAddress, appliedDiscount), all optional
complete-draft-order
- Complete a draft order, converting it into a real order
- Inputs:
  - draftOrderId (string, required): Draft order GID
  - paymentGatewayId (string, optional): Payment gateway GID
delete-draft-order
- Delete a draft order. Irreversible.
- Inputs:
  - draftOrderId (string, required): Draft order GID

Metafield Management (6 tools)

get-metafields
- Get metafields for any Shopify resource (products, orders, customers, variants, collections, etc.)
- Inputs:
  - ownerId (string, required): GID of any resource
  - namespace (string, optional): Filter by namespace
  - first (number, default: 25): Number of metafields to return
  - after (string, optional): Pagination cursor
set-metafields
- Set metafields on any Shopify resource. Creates or updates up to 25 metafields atomically
- Inputs:
  - metafields (array, required): Metafields to set, each with ownerId, key, value, and optional namespace, type
delete-metafields
- Delete metafields from any Shopify resource
- Inputs:
  - metafields (array, required): Metafields to delete, each with ownerId, namespace, key
create-metafield-definition
- Declare a reusable custom field on a resource type. Values are then set per-resource with set-metafields
- Inputs:
  - ownerType (string, required): e.g. PRODUCT, ORDER, CUSTOMER (underscore aliases normalized)
  - key (string, required): Unique identifier within the namespace
  - name (string, required): Human-readable name shown in the admin
  - type (string, required): e.g. single_line_text_field, number_integer, list.product_reference
  - namespace, description (string, optional)
  - pin (boolean, optional): Pin the definition in the admin
  - validations (array, optional): { name, value } type-specific rules
update-metafield-definition
- Update a definition's name, description, pinning, or validations. The type cannot be changed after creation
- Inputs:
  - ownerType (string, required) and key (string, required): Identify the definition
  - namespace (string, optional): Also part of the identifier
  - name, description (string, optional), pin (boolean, optional), validations (array, optional)
delete-metafield-definition
- Delete a definition, by GID or by ownerType + key
- Inputs:
  - definitionId (string, optional): Definition GID — or use ownerType + key instead
  - ownerType, key, namespace (optional): Identify the definition without a GID
  - deleteAllAssociatedMetafields (boolean, default: false): Also erase the stored values on every resource. Destructive and irreversible

Metaobject Management (6 tools)

get-metaobject-definitions
- Discover which metaobject types exist, with their field definitions. Call this first to learn the type and field keys the other metaobject tools need
- Inputs:
  - first (number, default: 50, max 100): Number of definitions to return
  - after (string, optional): Pagination cursor
get-metaobjects
- List metaobject entries of a given type, with filtering, pagination, and sorting
- Inputs:
  - type (string, required): Definition type, e.g. "size_chart"
  - limit (number, default: 10): Number of entries to return
  - query (string, optional): Filter, e.g. "display_name:winter" or "fields.season:winter"
  - sortKey (string, optional): One of id, type, updated_at, display_name
  - reverse (boolean, optional): Reverse the sort order
  - after / before (string, optional): Pagination cursors
get-metaobject-by-id
- Get a single metaobject, by GID or by type + handle
- Inputs:
  - metaobjectId (string, optional): Metaobject GID — or use type + handle instead
  - type / handle (string, optional): Look up by handle within a definition type
create-metaobject
- Create a metaobject entry for an existing definition
- Inputs:
  - type (string, required): Definition type
  - fields (array, required): { key, value } pairs; values are always strings (JSON-encoded for list/reference types)
  - handle (string, optional): Auto-generated if omitted
  - status (string, optional): "ACTIVE" or "DRAFT", when the definition is publishable
update-metaobject
- Update an entry. Fields are patched individually, so omitted keys keep their current values
- Inputs:
  - metaobjectId (string, required): Metaobject GID
  - fields (array, optional): { key, value } pairs to patch
  - handle (string, optional), status (string, optional)
  - redirectNewHandle (boolean, optional): Redirect the old handle when changing it
delete-metaobject
- Delete a metaobject entry. Irreversible, and breaks any references to it from other resources
- Inputs:
  - metaobjectId (string, required): Metaobject GID

Inventory Management (1 tool)

inventory-set-quantities
- Set absolute inventory quantities for items at specific locations
- Inputs:
  - reason (string, required): Reason for change (e.g. "correction", "cycle_count_available")
  - name (string, required): "available" or "on_hand"
  - quantities (array, required): Items with inventoryItemId, locationId, quantity

Tag Management (1 tool)

manage-tags
- Add or remove tags on any taggable resource (orders, products, customers, draft orders, articles)
- Inputs:
  - id (string, required): GID of the resource
  - tags (array of strings, required): Tags to add or remove
  - action (string, required): "add" or "remove"

Order Query Filter Reference

The get-orders tool's query parameter supports Shopify search syntax:

| Filter | Example | |--------|---------| | name | name:#77235 | | created_at | created_at:>2024-01-01 or created_at:2024-01-01..2024-03-31 | | updated_at | updated_at:>2024-06-01 | | financial_status | financial_status:paid | | fulfillment_status | fulfillment_status:shipped | | status | status:open | | email | email:[email protected] | | tag / tag_not | tag:vip tag_not:wholesale | | discount_code | discount_code:SUMMER20 | | sku | sku:PROD-001 | | risk_level | risk_level:high | | gateway | gateway:shopify_payments | | test | test:true |

Debugging

If you encounter issues, check Claude Desktop's MCP logs:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

License

MIT

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

Shopify MCP Server

Features

Prerequisites

Setup

Authentication

Option 1: Client Credentials (Dev Dashboard apps, January 2026+)

Option 2: Static Access Token (legacy apps)

Usage with Claude Desktop

Usage with Claude Code

Alternative: Run Locally with Environment Variables

Direct Installation (Optional)

Additional Options

Available Tools (57)

Pagination, Sorting & Filtering

Product Management (8 tools)

Customer Management (8 tools)

Order Management (9 tools)

Draft Order Management (6 tools)

Metafield Management (6 tools)

Metaobject Management (6 tools)

Inventory Management (1 tool)

Tag Management (1 tool)

Order Query Filter Reference

Debugging

License