io.github.codespar/mcp-shopify

io.github.codespar/mcp-shopify · 273 stars · TypeScript · MIT

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

Install

The repo has no one-line install. Follow its README.

Published as

npm@codespar/mcp-shopifystdio

From the server's entry in the official MCP Registry.

Open the repo

Configuration

Name	Set as	What it is
`SHOPIFY_SHOP`Required	Env var	Shopify shop subdomain (e.g. 'acme' for acme.myshopify.com)
`SHOPIFY_ACCESS_TOKEN`Required · Secret	Env var	Shopify Admin API access token (private/custom app) sent as X-Shopify-Access-Token header
`SHOPIFY_API_VERSION`Optional	Env var	Shopify Admin API version. Defaults to 2024-01.

Files

packages/ecommerce/shopify/README.md

@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)

Tool	Purpose
`list_orders`	List orders with optional filters.
`get_order`	Get a single order by ID with full detail.
`create_order`	Create a new order.
`update_order`	Update an existing order (tags, note, email, shipping_address, metafields, etc).
`cancel_order`	Cancel an order.
`list_products`	List products with optional filters.
`get_product`	Get a single product by ID including all variants and images.
`create_product`	Create a new product with variants, options, and images.
`update_product`	Update an existing product's fields, variants, or images.
`list_customers`	List customers with optional query filter.
`create_customer`	Create a new customer record.
`adjust_inventory`	Adjust the available inventory for a specific inventory_item at a specific location by a delta (positive to...
`create_fulfillment`	Create a fulfillment for an order (mark line items as shipped, attach tracking number and carrier).
`update_fulfillment_tracking`	Update the tracking number, tracking company, or tracking URL on an existing fulfillment (post-ship trackin...
`create_draft_order`	Create a draft order (invoice-style quote).
`complete_draft_order`	Convert a draft order into a real order.
`create_price_rule`	Create a price rule (the policy that governs discounts — percentage/fixed amount, prerequisites, entitlemen...
`create_discount_code`	Create a discount code tied to an existing price rule (the customer-facing string like 'SUMMER20').
`create_smart_collection`	Create a smart collection — an automated collection populated by rules (e.g.
`create_custom_collection`	Create a custom collection — a manually curated collection.
`create_metafield`	Attach a metafield (custom typed field) to a resource (shop, product, variant, customer, order, collection,...
`create_variant`	Add a new variant to an existing product (size/color/SKU permutation with its own price and inventory).
`update_variant`	Update an existing product variant's price, SKU, barcode, options, weight, or inventory policy.
`list_transactions`	List all payment transactions for an order (authorizations, captures, sales, refunds, voids) including gate...
`list_abandoned_checkouts`	List abandoned checkouts (carts where the customer entered contact info but did not complete checkout).
`list_locations`	List all fulfillment locations (physical stores, warehouses, 3PLs).
`create_refund`	Refund one or more line items on an order.
`register_webhook`	Register a webhook subscription for a Shopify event topic (orders/create, orders/paid, products/update, app...

Install

npm install @codespar/mcp-shopify

Environment

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

# 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

Facts

Kind: MCP server
Repo: codespar/mcp-dev-latam
Group: Uncategorized
Stars: 273
License: MIT
Language: TypeScript
Last push: 2026-09-27
Forks: 50
MCP Registry: io.github.codespar/mcp-shopify
Homepage: codespar.dev/servers
Topics: agentic-commerce, ai-agents, brazil, claude, fintech, latin-america, llm-tools, mcp, model-context-protocol, nfe, open-finance, payments, pix

io.github.codespar/mcp-shopify

Install

Published as

Configuration

Files

@codespar/mcp-shopify

Tools (28)

Install

Environment

Authentication

Run

API surface

Enterprise

License

Facts

More on this shelf