Package Exports

@codespar/mcp-shopify
@codespar/mcp-shopify/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@codespar/mcp-shopify) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

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)

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.

License

MIT