Mcp Shopify

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Nov 3, 2026

MCP server for Shopify — Admin REST API (orders, products, customers, inventory, fulfillments)

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Shopify Admin REST API MCP server that lets an assistant read and change orders, products, customers, inventory, fulfillments, discounts and refunds in a store.

What you can do
  • List, read, create, update and cancel orders, including draft orders and abandoned checkouts
  • List, read, create and update products, variants, images, smart and custom collections, and metafields
  • List and create customers
  • Adjust inventory by delta at a location and list fulfillment locations
  • Create fulfillments, update tracking details, list order transactions and issue refunds
  • Create price rules and discount codes, and register webhook subscriptions
When to use it
Useful when an assistant should work directly against a Shopify store's admin data — for example restocking, order and refund handling, fulfillment orchestration, catalog or discount setup — instead of going through a reseller or manual admin clicks.
Requirements
Runs locally over stdio via the npm package (npx @codespar/mcp-shopify); Node.js and network access to the shop's myshopify.com domain are needed. Requires SHOPIFY_SHOP (shop subdomain) and SHOPIFY_ACCESS_TOKEN, a private or custom app Admin API token; SHOPIFY_API_VERSION is optional and defaults to 2024-01. The custom app must be granted the Admin API scopes you need.
Before you install
The token grants write access to live store data: the tools create, update and cancel orders, change products and inventory, issue refunds, create discount codes and register webhooks, so mistakes affect real customers and money. Grant only the scopes you need and keep SHOPIFY_ACCESS_TOKEN secret. Refunds and discount creation have financial impact. The README also mentions a paid enterprise offering, which is separate from this package.

Installation

In SourceWeft

  1. Open Mcp Shopify in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-shopify

MCP server for Shopify — global ecommerce platform Admin REST API.

Shopify is the global DTC standard and dominant across LatAm for brands operating internationally (complementary to Nuvemshop/Tiendanube for regional-only merchants, also in this catalog). Agents building merchant tools — restocking, refund automation, marketing campaigns, fulfillment orchestration — integrate directly with the Admin API rather than through a reseller.

Tools (28)

ToolPurpose
list_ordersList orders with optional filters.
get_orderGet a single order by ID with full detail.
create_orderCreate a new order.
update_orderUpdate an existing order (tags, note, email, shipping_address, metafields, etc).
cancel_orderCancel an order.
list_productsList products with optional filters.
get_productGet a single product by ID including all variants and images.
create_productCreate a new product with variants, options, and images.
update_productUpdate an existing product's fields, variants, or images.
list_customersList customers with optional query filter.
create_customerCreate a new customer record.
adjust_inventoryAdjust the available inventory for a specific inventory_item at a specific location by a delta (positive to...
create_fulfillmentCreate a fulfillment for an order (mark line items as shipped, attach tracking number and carrier).
update_fulfillment_trackingUpdate the tracking number, tracking company, or tracking URL on an existing fulfillment (post-ship trackin...
create_draft_orderCreate a draft order (invoice-style quote).
complete_draft_orderConvert a draft order into a real order.
create_price_ruleCreate a price rule (the policy that governs discounts — percentage/fixed amount, prerequisites, entitlemen...
create_discount_codeCreate a discount code tied to an existing price rule (the customer-facing string like 'SUMMER20').
create_smart_collectionCreate a smart collection — an automated collection populated by rules (e.g.
create_custom_collectionCreate a custom collection — a manually curated collection.
create_metafieldAttach a metafield (custom typed field) to a resource (shop, product, variant, customer, order, collection,...
create_variantAdd a new variant to an existing product (size/color/SKU permutation with its own price and inventory).
update_variantUpdate an existing product variant's price, SKU, barcode, options, weight, or inventory policy.
list_transactionsList all payment transactions for an order (authorizations, captures, sales, refunds, voids) including gate...
list_abandoned_checkoutsList abandoned checkouts (carts where the customer entered contact info but did not complete checkout).
list_locationsList all fulfillment locations (physical stores, warehouses, 3PLs).
create_refundRefund one or more line items on an order.
register_webhookRegister a webhook subscription for a Shopify event topic (orders/create, orders/paid, products/update, app...

Install

bash
npm install @codespar/mcp-shopify

Environment

bash
SHOPIFY_SHOP="acme"               # subdomain (acme.myshopify.com)SHOPIFY_ACCESS_TOKEN="shpat_..."  # Admin API access token (secret)SHOPIFY_API_VERSION="2024-01"     # Optional. Defaults to 2024-01.

Authentication

Private/custom app access token sent as header on every request:

X-Shopify-Access-Token: <SHOPIFY_ACCESS_TOKEN>

Create a custom app in Shopify admin → Settings → Apps and sales channels → Develop apps, grant the Admin API scopes you need (read/write orders, products, customers, inventory, fulfillments), and install to generate the token.

Run

bash
# stdio (default — for Claude Desktop, Cursor, etc)npx @codespar/mcp-shopify
# HTTP (for server-to-server testing)MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-shopify

API surface

Uses the Shopify Admin REST API at https://{shop}.myshopify.com/admin/api/{version}. Default version is 2024-01 (stable). Override with SHOPIFY_API_VERSION when newer stable versions ship.

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

Source: packages/ecommerce/shopify/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts