Skip to content
Back to search

shopify-mcp

MCP server for Shopify api, usable on mcp hosts such as Claude and Cursor

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/geli2001--shopify-mcp/badge.svg)](/listings/geli2001--shopify-mcp)

HTML

<a href="/listings/geli2001--shopify-mcp"><img src="/api/listings/geli2001--shopify-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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.

1. From your Shopify admin, go to **Settings** > **Apps and sales channels** 2. Click **Develop apps** > **Build app in dev dashboard** 3. Create a new app and configure **Admin API scopes**: - `read_products`, `write_products` - `read_customers`, `write_customers` - `read_orders`, `write_orders` 4. Install the app on your store 5. 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",
        "--clientId",
        "<YOUR_CLIENT_ID>",
        "--clientSecret",
        "<YOUR_CLIENT_SECRET>",
        "--domain",
        "<YOUR_SHOP>.myshopify.com"
      ]
    }
  }
}

**Static Access Token (legacy):**

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": [
        "shopify-mcp",
        "--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 \
  --clientId YOUR_CLIENT_ID \
  --clientSecret YOUR_CLIENT_SECRET \
  --domain your-store.myshopify.com

**Static Access Token (legacy):**

claude mcp add shopify -- npx shopify-mcp \
  --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:

1. 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

2. Run the server with npx:

   npx shopify-mcp

Direct Installation (Optional)

If you want to install the package globally:

npm install -g shopify-mcp

Then run it:

shopify-mcp --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`, not `shopify-mcp-server`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 533 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Shopify MCP Server
  2. (please leave a star if you like!)
  3. MCP Server for Shopify API, enabling interaction with store data through GraphQL API. This server provides tools for managing products, customers, orders, and more.
  4. **📦 Package Name: `shopify-mcp`**
  5. **🚀 Command: `shopify-mcp` (NOT `shopify-mcp-server`)**
  6. <a href="https://glama.ai/mcp/servers/@GeLi2001/shopify-mcp">
  7. <img width="380" height="200" src="https://glama.ai/mcp/servers/@GeLi2001/shopify-mcp/badge" alt="Shopify MCP server" />
  8. </a>
  9. ## Features
  10. - **Product Management**: Full CRUD for products, variants, and options (8 tools)
  11. - **Customer Management**: Full CRUD, merge, and address management (8 tools)
  12. - **Order Management**: Smart lookup, cancel, close/open, mark as paid, fulfillment, refunds (10 tools)
  13. - **Metafield Management**: Get, set, and delete metafields on any resource (3 tools)
  14. - **Inventory Management**: Set absolute inventory quantities at locations (1 tool)
  15. - **Tag Management**: Add/remove tags on any taggable resource (1 tool)
  16. - **Pagination & Sorting**: Cursor-based pagination and sort keys on all list queries
  17. - **Advanced Filtering**: Pass-through Shopify query syntax for all list endpoints
  18. - **GraphQL Integration**: Direct integration with Shopify's GraphQL Admin API (2026-01)
  19. - **Comprehensive Error Handling**: Clear error messages for API and authentication issues
  20. ## Prerequisites
  21. 1. Node.js (version 18 or higher)
  22. 2. A Shopify store with a custom app (see setup instructions below)
  23. ## Setup
  24. ### Authentication
  25. This server supports two authentication methods:
  26. #### Option 1: Client Credentials (Dev Dashboard apps, January 2026+)
  27. As of January 1, 2026, new Shopify apps are created in the **Dev Dashboard** and use OAuth client credentials instead of static access tokens.
  28. 1. From your Shopify admin, go to **Settings** > **Apps and sales channels**
  29. 2. Click **Develop apps** > **Build app in dev dashboard**
  30. 3. Create a new app and configure **Admin API scopes**:
  31. - `read_products`, `write_products`
  32. - `read_customers`, `write_customers`
  33. - `read_orders`, `write_orders`
  34. 4. Install the app on your store
  35. 5. Copy your **Client ID** and **Client Secret** from the app's API credentials
  36. The server will automatically exchange these for an access token and refresh it before it expires (tokens are valid for ~24 hours).
  37. #### Option 2: Static Access Token (legacy apps)
  38. If you have an existing custom app with a static `shpat_` access token, you can still use it directly.
  39. ### Usage with Claude Desktop
  40. **Client Credentials (recommended):**
  41. ```json
  42. {
  43. "mcpServers": {
  44. "shopify": {
  45. "command": "npx",
  46. "args": [
  47. "shopify-mcp",
  48. "--clientId",
  49. "<YOUR_CLIENT_ID>",
  50. "--clientSecret",
  51. "<YOUR_CLIENT_SECRET>",
  52. "--domain",
  53. "<YOUR_SHOP>.myshopify.com"
  54. ]
  55. }
  56. }
  57. }
  58. ```
  59. **Static Access Token (legacy):**
  60. ```json
  61. {
  62. "mcpServers": {
  63. "shopify": {
  64. "command": "npx",
  65. "args": [
  66. "shopify-mcp",
  67. "--accessToken",
  68. "<YOUR_ACCESS_TOKEN>",
  69. "--domain",
  70. "<YOUR_SHOP>.myshopify.com"
  71. ]
  72. }
  73. }
  74. }
  75. ```
  76. Locations for the Claude Desktop config file:
  77. - MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
  78. - Windows: `%APPDATA%/Claude/claude_desktop_config.json`
  79. ### Usage with Claude Code
  80. **Client Credentials:**
  81. ```bash
  82. claude mcp add shopify -- npx shopify-mcp \
  83. --clientId YOUR_CLIENT_ID \
  84. --clientSecret YOUR_CLIENT_SECRET \
  85. --domain your-store.myshopify.com
  86. ```
  87. **Static Access Token (legacy):**
  88. ```bash
  89. claude mcp add shopify -- npx shopify-mcp \
  90. --accessToken YOUR_ACCESS_TOKEN \
  91. --domain your-store.myshopify.com
  92. ```
  93. ### Alternative: Run Locally with Environment Variables
  94. If you prefer to use environment variables instead of command-line arguments:
  95. 1. Create a `.env` file with your Shopify credentials:
  96. **Client Credentials:**
  97. ```
  98. SHOPIFY_CLIENT_ID=your_client_id
  99. SHOPIFY_CLIENT_SECRET=your_client_secret
  100. MYSHOPIFY_DOMAIN=your-store.myshopify.com
  101. ```
  102. **Static Access Token (legacy):**
  103. ```
  104. SHOPIFY_ACCESS_TOKEN=your_access_token
  105. MYSHOPIFY_DOMAIN=your-store.myshopify.com
  106. ```
  107. 2. Run the server with npx:
  108. ```
  109. npx shopify-mcp
  110. ```
  111. ### Direct Installation (Optional)
  112. If you want to install the package globally:
  113. ```
  114. npm install -g shopify-mcp
  115. ```
  116. Then run it:
  117. ```
  118. shopify-mcp --clientId=<ID> --clientSecret=<SECRET> --domain=<YOUR_SHOP>.myshopify.com
  119. ```
  120. ### Additional Options
  121. - `--apiVersion`: Specify the Shopify API version (default: `2026-01`). Can also be set via `SHOPIFY_API_VERSION` environment variable.
  122. **⚠️ 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`, not `shopify-mcp-server`.
  123. ## Available Tools (31)
  124. ### Pagination, Sorting & Filtering
  125. All list query tools (`get-products`, `get-customers`, `get-orders`, `get-customer-orders`) support:
  126. - **Cursor-based pagination**: `after` / `before` (cursor strings), with `pageInfo` in the response (`hasNextPage`, `hasPreviousPage`, `startCursor`, `endCursor`)
  127. - **Sorting**: `sortKey` (enum specific to each resource) and `reverse` (boolean)
  128. - **Advanced filtering**: `query` or `searchQuery` parameter accepting [Shopify query syntax](https://shopify.dev/docs/api/usage/search-syntax)
  129. ### Product Management (8 tools)
  130. 1. **`get-products`**
  131. - Get all products or search by title with pagination and sorting
  132. - Inputs:
  133. - `searchTitle` (string, optional): Filter products by title (wraps in `title:*...*`)
  134. - `limit` (number, default: 10): Maximum number of products to return
  135. - `query` (string, optional): Raw Shopify query string (e.g. `"status:active vendor:Nike tag:sale"`)
  136. - `sortKey` (string, optional): One of `CREATED_AT`, `ID`, `INVENTORY_TOTAL`, `PRODUCT_TYPE`, `PUBLISHED_AT`, `RELEVANCE`, `TITLE`, `UPDATED_AT`, `VENDOR`
  137. - `reverse` (boolean, optional): Reverse the sort order
  138. - `after` / `before` (string, optional): Pagination cursors
  139. 2. **`get-product-by-id`**
  140. - Get a specific product by ID with full details including SEO, options, media, variants, and collections
  141. - Inputs:
  142. - `productId` (string, required): Shopify product GID
  143. - Returns: `productType`, `descriptionHtml`, `seo`, `options` (with `optionValues`), `media` (images), `variants`, `collections`, `tags`, `vendor`, price range, inventory
  144. 3. **`create-product`**
  145. - 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.
  146. - Inputs:
  147. - `title` (string, required): Title of the product
  148. - `descriptionHtml` (string, optional): Description with HTML
  149. - `handle` (string, optional): URL slug. Auto-generated from title if omitted
  150. - `vendor` (string, optional): Vendor of the product
  151. - `productType` (string, optional): Type of the product
  152. - `tags` (array of strings, optional): Product tags
  153. - `status` (string, optional): `"ACTIVE"`, `"DRAFT"`, or `"ARCHIVED"`. Default `"DRAFT"`
  154. - `seo` (object, optional): `{ title, description }` for search engines
  155. - `metafields` (array of objects, optional): Custom metafields (`namespace`, `key`, `value`, `type`)
  156. - `productOptions` (array of objects, optional): Options to create inline, e.g. `[{ name: "Size", values: [{ name: "S" }, { name: "M" }] }]`. Max 3 options.
  157. - `collectionsToJoin` (array of strings, optional): Collection GIDs to add the product to
  158. 4. **`update-product`**
  159. - Update an existing product's fields
  160. - Inputs:
  161. - `id` (string, required): Shopify product GID
  162. - `title` (string, optional): New title
  163. - `descriptionHtml` (string, optional): New description
  164. - `handle` (string, optional): New URL slug
  165. - `vendor` (string, optional): New vendor
  166. - `productType` (string, optional): New product type
  167. - `tags` (array of strings, optional): New tags (overwrites existing)
  168. - `status` (string, optional): `"ACTIVE"`, `"DRAFT"`, or `"ARCHIVED"`
  169. - `seo` (object, optional): `{ title, description }` for search engines
  170. - `metafields` (array of objects, optional): Metafields to set or update
  171. - `collectionsToJoin` (array of strings, optional): Collection GIDs to add the product to
  172. - `collectionsToLeave` (array of strings, optional): Collection GIDs to remove the product from
  173. - `redirectNewHandle` (boolean, optional): If true, old handle redirects to new handle
  174. 5. **`delete-product`**
  175. - Delete a product
  176. - Inputs:
  177. - `id` (string, required): Shopify product GID
  178. 6. **`manage-product-options`**
  179. - Create, update, or delete product options (e.g. Size, Color)
  180. - Inputs:
  181. - `productId` (string, required): Shopify product GID
  182. - `action` (string, required): `"create"`, `"update"`, or `"delete"`
  183. - `variantStrategy` (string, optional): `"LEAVE_AS_IS"` (default) or `"CREATE"` — controls whether new variant combinations are generated when adding options
  184. - For `action: "create"`:
  185. - `options` (array, required): Options to create, e.g. `[{ name: "Size", values: ["S", "M", "L"] }]`
  186. - For `action: "update"`:
  187. - `optionId` (string, required): Option GID to update
  188. - `name` (string, optional): New name for the option
  189. - `position` (number, optional): New position
  190. - `valuesToAdd` (array of strings, optional): Values to add
  191. - `valuesToDelete` (array of strings, optional): Value GIDs to remove
  192. - For `action: "delete"`:
  193. - `optionIds` (array of strings, required): Option GIDs to delete
  194. 7. **`manage-product-variants`**
  195. - Create or update product variants in bulk
  196. - Inputs:
  197. - `productId` (string, required): Shopify product GID
  198. - `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"`
  199. - `variants` (array, required): Variants to create or update. Each variant:
  200. - `id` (string, optional): Variant GID for updates. Omit to create new
  201. - `price` (string, optional): Price, e.g. `"49.00"`
  202. - `compareAtPrice` (string, optional): Compare-at price for showing discounts
  203. - `sku` (string, optional): SKU (mapped to `inventoryItem.sku`)
  204. - `tracked` (boolean, optional): Whether inventory is tracked. Set `false` for print-on-demand
  205. - `taxable` (boolean, optional): Whether the variant is taxable
  206. - `barcode` (string, optional): Barcode
  207. - `weight` (number, optional): Weight of the variant
  208. - `weightUnit` (string, optional): `"GRAMS"`, `"KILOGRAMS"`, `"OUNCES"`, or `"POUNDS"`
  209. - `optionValues` (array, optional): Option values, e.g. `[{ optionName: "Size", name: "A4" }]`
  210. 8. **`delete-product-variants`**
  211. - Delete one or more variants from a product
  212. - Inputs:
  213. - `productId` (string, required): Shopify product GID
  214. - `variantIds` (array of strings, required): Variant GIDs to delete
  215. ### Customer Management (8 tools)
  216. 1. **`get-customers`**
  217. - List customers with search, pagination, and sorting
  218. - Inputs:
  219. - `searchQuery` (string, optional): Freetext or Shopify query syntax (e.g. `"country:US tag:vip orders_count:>5"`)
  220. - `limit` (number, default: 10): Maximum number of customers to return
  221. - `sortKey` (string, optional): One of `CREATED_AT`, `ID`, `LAST_UPDATE`, `LOCATION`, `NAME`, `ORDERS_COUNT`, `RELEVANCE`, `TOTAL_SPENT`, `UPDATED_AT`
  222. - `reverse` (boolean, optional): Reverse the sort order
  223. - `after` / `before` (string, optional): Pagination cursors
  224. 2. **`get-customer-by-id`**
  225. - Get a single customer by ID with full details
  226. - Inputs:
  227. - `id` (string, required): Shopify customer ID (numeric only, e.g. `"6276879810626"`)
  228. - Returns: name, email, phone, addresses, tags, note, tax status, amount spent, order count, metafields
  229. 3. **`create-customer`**
  230. - Create a new customer
  231. - Inputs:
  232. - `firstName` (string, optional): Customer's first name
  233. - `lastName` (string, optional): Customer's last name
  234. - `email` (string, optional): Customer's email address
  235. - `phone` (string, optional): Customer's phone number
  236. - `tags` (array of strings, optional): Tags to apply
  237. - `note` (string, optional): Note about the customer
  238. - `taxExempt` (boolean, optional): Whether the customer is exempt from taxes
  239. - `metafields` (array of objects, optional): Custom metafields (`namespace`, `key`, `value`, `type`)
  240. - `addresses` (array of objects, optional): Customer addresses (`address1`, `address2`, `city`, `provinceCode`, `zip`, `country`, `phone`)
  241. 4. **`update-customer`**
  242. - Update a customer's information
  243. - Inputs:
  244. - `id` (string, required): Shopify customer ID (numeric only, e.g. `"6276879810626"`)
  245. - `firstName` (string, optional): Customer's first name
  246. - `lastName` (string, optional): Customer's last name
  247. - `email` (string, optional): Customer's email address
  248. - `phone` (string, optional): Customer's phone number
  249. - `tags` (array of strings, optional): Tags to apply to the customer
  250. - `note` (string, optional): Note about the customer
  251. - `taxExempt` (boolean, optional): Whether the customer is exempt from taxes
  252. - `emailMarketingConsent` (object, optional): Email marketing consent settings
  253. - `marketingState` (string, required): `"NOT_SUBSCRIBED"`, `"SUBSCRIBED"`, `"UNSUBSCRIBED"`, or `"PENDING"`
  254. - `consentUpdatedAt` (string, optional): ISO 8601 timestamp
  255. - `marketingOptInLevel` (string, optional): `"SINGLE_OPT_IN"`, `"CONFIRMED_OPT_IN"`, or `"UNKNOWN"`
  256. - `metafields` (array of objects, optional): Customer metafields
  257. 5. **`delete-customer`**
  258. - Delete a customer
  259. - Inputs:
  260. - `id` (string, required): Shopify customer ID (numeric only, e.g. `"6276879810626"`)
  261. 6. **`customer-merge`**
  262. - Merge two customer records into one
  263. - Inputs:
  264. - `customerOneId` (string, required): GID of the first customer
  265. - `customerTwoId` (string, required): GID of the second customer
  266. - `overrideFields` (object, optional): Override which fields to keep from which customer (firstName, lastName, email, phone, defaultAddress, note, tags)
  267. 7. **`manage-customer-address`**
  268. - Create, update, or delete a customer's mailing address
  269. - Inputs:
  270. - `customerId` (string, required): Customer GID
  271. - `action` (string, required): `"create"`, `"update"`, or `"delete"`
  272. - `addressId` (string, optional): Address GID (required for update/delete)
  273. - `address` (object, optional): Address fields (required for create/update): `address1`, `address2`, `city`, `company`, `countryCode`, `firstName`, `lastName`, `phone`, `provinceCode`, `zip`
  274. - `setAsDefault` (boolean, optional): Set as customer's default address
  275. ### Order Management (10 tools)
  276. 1. **`get-orders`**
  277. - Get orders with filtering, pagination, and sorting
  278. - Inputs:
  279. - `status` (string, optional): `"any"`, `"open"`, `"closed"`, or `"cancelled"`. Default `"any"`
  280. - `limit` (number, default: 10): Maximum number of orders to return
  281. - `query` (string, optional): Raw Shopify query string (e.g. `"financial_status:paid fulfillment_status:shipped tag:rush"`)
  282. - `sortKey` (string, optional): One of `CREATED_AT`, `ORDER_NUMBER`, `TOTAL_PRICE`, `FINANCIAL_STATUS`, `FULFILLMENT_STATUS`, `UPDATED_AT`, `CUSTOMER_NAME`, `PROCESSED_AT`, `ID`, `RELEVANCE`
  283. - `reverse` (boolean, optional): Reverse the sort order
  284. - `after` / `before` (string, optional): Pagination cursors
  285. 2. **`get-order-by-id`**
  286. - Get a specific order by ID with smart lookup — accepts order name (`#77235` or `77235`), numeric ID (`8054938337547`), or full GID (`gid://shopify/Order/...`)
  287. - Inputs:
  288. - `orderId` (string, required): Order name, numeric ID, or full GID
  289. - Returns: pricing, customer, shipping/billing addresses, line items, tags, notes, metafields, cancel reason, return status, discount codes, PO number, timestamps
  290. 3. **`update-order`**
  291. - Update an existing order
  292. - Inputs:
  293. - `id` (string, required): Shopify order GID
  294. - `tags` (array of strings, optional): New tags for the order
  295. - `email` (string, optional): Update customer email on the order
  296. - `note` (string, optional): Order notes
  297. - `phone` (string, optional): Phone number for the order
  298. - `poNumber` (string, optional): Purchase order number
  299. - `customAttributes` (array of objects, optional): Custom key-value attributes
  300. - `metafields` (array of objects, optional): Order metafields
  301. - `shippingAddress` (object, optional): Shipping address fields
  302. 4. **`get-customer-orders`**
  303. - Get orders for a specific customer with pagination and sorting
  304. - Inputs:
  305. - `customerId` (string, required): Shopify customer ID (numeric only, e.g. `"6276879810626"`)
  306. - `limit` (number, default: 10): Maximum number of orders to return
  307. - `sortKey` (string, optional): Same sort keys as `get-orders`
  308. - `reverse` (boolean, optional): Reverse the sort order
  309. - `after` / `before` (string, optional): Pagination cursors
  310. 5. **`order-cancel`**
  311. - Cancel an order with options for refunding, restocking, and customer notification. **Irreversible.**
  312. - Inputs:
  313. - `orderId` (string, required): Order GID
  314. - `reason` (string, required): `"CUSTOMER"`, `"DECLINED"`, `"FRAUD"`, `"INVENTORY"`, `"OTHER"`, or `"STAFF"`
  315. - `restock` (boolean, required): Whether to restock inventory
  316. - `notifyCustomer` (boolean, default: false): Notify the customer
  317. - `staffNote` (string, optional): Internal note
  318. - `refund` (boolean, optional): Refund to original payment method
  319. 6. **`order-close-open`**
  320. - Close or reopen an order
  321. - Inputs:
  322. - `orderId` (string, required): Order GID
  323. - `action` (string, required): `"close"` or `"open"`
  324. 7. **`order-mark-as-paid`**
  325. - Mark an order as paid (for manual/offline payments)
  326. - Inputs:
  327. - `orderId` (string, required): Order GID
  328. 8. **`create-fulfillment`**
  329. - Create a fulfillment (mark items as shipped) with optional tracking
  330. - Inputs:
  331. - `lineItemsByFulfillmentOrder` (array, required): Fulfillment orders and line items to fulfill
  332. - `trackingInfo` (object, optional): `{ number, url, company }` tracking details
  333. - `notifyCustomer` (boolean, default: false): Send shipping notification
  334. 9. **`refund-create`**
  335. - Create a full or partial refund with optional restocking
  336. - Inputs:
  337. - `orderId` (string, required): Order GID
  338. - `refundLineItems` (array, optional): Line items to refund with `lineItemId`, `quantity`, `restockType` (`CANCEL`/`RETURN`/`NO_RESTOCK`), `locationId`
  339. - `shipping` (object, optional): `{ amount, fullRefund }` shipping refund
  340. - `note` (string, optional): Refund note
  341. - `notify` (boolean, optional): Send refund notification
  342. 10. **`create-draft-order`**
  343. - Create a draft order for phone/chat sales, invoicing, or wholesale
  344. - Inputs:
  345. - `lineItems` (array, required): Product variants (`variantId`) or custom items (`title` + price). Max 499
  346. - `customerId` (string, optional): Customer GID
  347. - `email`, `phone`, `note`, `tags`, `poNumber` (optional)
  348. - `shippingAddress`, `billingAddress` (objects, optional)
  349. - `appliedDiscount` (object, optional): `{ title, value, valueType }` order-level discount
  350. ### Draft Order Management (1 tool)
  351. 1. **`complete-draft-order`**
  352. - Complete a draft order, converting it into a real order
  353. - Inputs:
  354. - `draftOrderId` (string, required): Draft order GID
  355. - `paymentGatewayId` (string, optional): Payment gateway GID
  356. ### Metafield Management (3 tools)
  357. 1. **`get-metafields`**
  358. - Get metafields for any Shopify resource (products, orders, customers, variants, collections, etc.)
  359. - Inputs:
  360. - `ownerId` (string, required): GID of any resource
  361. - `namespace` (string, optional): Filter by namespace
  362. - `first` (number, default: 25): Number of metafields to return
  363. - `after` (string, optional): Pagination cursor
  364. 2. **`set-metafields`**
  365. - Set metafields on any Shopify resource. Creates or updates up to 25 metafields atomically
  366. - Inputs:
  367. - `metafields` (array, required): Metafields to set, each with `ownerId`, `key`, `value`, and optional `namespace`, `type`
  368. 3. **`delete-metafields`**
  369. - Delete metafields from any Shopify resource
  370. - Inputs:
  371. - `metafields` (array, required): Metafields to delete, each with `ownerId`, `namespace`, `key`
  372. ### Inventory Management (1 tool)
  373. 1. **`inventory-set-quantities`**
  374. - Set absolute inventory quantities for items at specific locations
  375. - Inputs:
  376. - `reason` (string, required): Reason for change (e.g. `"correction"`, `"cycle_count_available"`)
  377. - `name` (string, required): `"available"` or `"on_hand"`
  378. - `quantities` (array, required): Items with `inventoryItemId`, `locationId`, `quantity`
  379. ### Tag Management (1 tool)
  380. 1. **`manage-tags`**
  381. - Add or remove tags on any taggable resource (orders, products, customers, draft orders, articles)
  382. - Inputs:
  383. - `id` (string, required): GID of the resource
  384. - `tags` (array of strings, required): Tags to add or remove
  385. - `action` (string, required): `"add"` or `"remove"`
  386. ### Order Query Filter Reference
  387. The `get-orders` tool's `query` parameter supports [Shopify search syntax](https://shopify.dev/docs/api/usage/search-syntax):
  388. | Filter | Example |
  389. |--------|---------|
  390. | `name` | `name:#77235` |
  391. | `created_at` | `created_at:>2024-01-01` or `created_at:2024-01-01..2024-03-31` |
  392. | `updated_at` | `updated_at:>2024-06-01` |
  393. | `financial_status` | `financial_status:paid` |
  394. | `fulfillment_status` | `fulfillment_status:shipped` |
  395. | `status` | `status:open` |
  396. | `email` | `email:customer@example.com` |
  397. | `tag` / `tag_not` | `tag:vip tag_not:wholesale` |
  398. | `discount_code` | `discount_code:SUMMER20` |
  399. | `sku` | `sku:PROD-001` |
  400. | `risk_level` | `risk_level:high` |
  401. | `gateway` | `gateway:shopify_payments` |
  402. | `test` | `test:true` |
  403. ## Debugging
  404. If you encounter issues, check Claude Desktop's MCP logs:
  405. ```
  406. tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
  407. ```
  408. ## License
  409. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.