io.github.codespar/mcp-shopify — MCP Server for Shopify

MCP server for Shopify that exposes the Shopify Admin REST API. It supports operations related to orders, products, customers, inventory, and fulfillments, enabling agent-based commerce workflows to connect directly to Shopify rather than via a reseller. The repository is associated with topics including mcp, Model Context Protocol, and AI tools.

🛠️ Key Features

Shopify Admin REST API access for orders, products, customers, inventory, and fulfillments
Tooling includes at least 28 tools

🚀 Use Cases

Restocking and fulfillment orchestration using the Admin API
Refund automation workflows
Marketing campaign integrations

⚡ Developer Benefits

Direct integration with Shopify (Shopify Admin REST API)
Supports LLM tool usage via MCP, with topics aligned to “llm-tools” and “agentic-commerce”

⚠️ Limitations

Described scope is limited to Shopify Admin REST API; no non-Admin endpoints are mentioned
Tool list details beyond the excerpt (e.g., full 28 tools) are not fully provided in the source data

@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

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:

code

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.

Install

Configuration

Environment variables

SHOPIFY_SHOPrequired

Shopify shop subdomain (e.g. 'acme' for acme.myshopify.com)

SHOPIFY_ACCESS_TOKENrequiredsecret

Shopify Admin API access token (private/custom app) sent as X-Shopify-Access-Token header

SHOPIFY_API_VERSION

Shopify Admin API version. Defaults to 2024-01.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-shopify": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-shopify@0.2.2"
      ],
      "env": {
        "SHOPIFY_SHOP": "<YOUR_SHOPIFY_SHOP>",
        "SHOPIFY_ACCESS_TOKEN": "<YOUR_SHOPIFY_ACCESS_TOKEN>",
        "SHOPIFY_API_VERSION": "<YOUR_SHOPIFY_API_VERSION>"
      }
    }
  }
}

io.github.codespar/mcp-shopify