Shopify

You can use the Shopify MCP Server to interact with store data through a GraphQL-friendly bridge. It provides focused tools for products, customers, orders, blogs, and more, enabling AI-assisted workflows and streamlined store management.

How to use

Install and run the MCP server using the standard CLI flow, then connect your MCP client (such as Claude Desktop) to issue high-level store operations. You will sign requests with a Shopify access token and point to your store domain. The server exposes tools for products, collections, blogs, articles, pages, and store-wide search, all accessible through an MCP client.

Typical usage patterns include listing products, updating product details and SEO, managing blog content, creating and editing articles, and performing unified store searches. You will send requests to the MCP server through your client and handle responses with clear error information when something goes wrong.

How to install

Prerequisites you need before installation are ready-to-use Node.js (version 16 or higher) and access to a Shopify Custom App with Admin API scopes.

# Ensure you have Node.js 16+ installed
node -v
npm -v

# Install the MCP package globally (optional, for convenience)
npm install -g best-shopify-mcp

# Run the MCP server using your access token and domain
best-shopify-mcp --accessToken <YOUR_ACCESS_TOKEN> --domain <YOUR_SHOP>.myshopify.com

If you prefer to connect via Claude Desktop, configure the client to pass your access token and store domain to the MCP server.

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": [
        "best-shopify-mcp",
        "--accessToken",
        "<YOUR_ACCESS_TOKEN>",
        "--domain",
        "<YOUR_SHOP>.myshopify.com"
      ]
    }
  }
}

Additional setup notes

If you run locally with environment variables, create a .env file with your credentials and start the server with npx.

# .env example
SHOPIFY_ACCESS_TOKEN=your_access_token
MYSHOPIFY_DOMAIN=your-store.myshopify.com

# Start without CLI args
npx best-shopify-mcp

Configuration tips and troubleshooting

Ensure you provide the full GID-based IDs for products, variants, blogs, and articles when updating content. Use the correct access scopes in Shopify and keep token handling secure. If you encounter credential errors, verify that you are using the exact MCP command name best-shopify-mcp and that you are not mixing with other packages.

The MCP server surfaces clear error messages for authentication, permission, or rate-limiting issues to help you resolve problems quickly. Review your token permissions, confirm your store domain, and respect Shopify API limits when performing batch operations.

Available tools

get-products

Fetch products or search by title with pagination and optional reverse order; returns product details including title, description, IDs, and cursor for paging.

get-product-by-id

Retrieve a single product by its GID, including full details like variants, images, and collections.

update-product

Update product fields such as title, SEO, status, vendor, type, tags, and variants; supports partial updates with guidance on IDs and formats.

update-product-image-alt-text

Update the alt text for a specific product image or media item.

get-collections

List collections or search by title with paging support.

get-blogs

Fetch blogs with optional search by title and return blog metadata.

update-blog

Modify blog details such as title, handle, template, and comment policy.

get-blog-by-id

Retrieve a single blog and its related articles.

get-articles

List articles within a blog with optional title filtering and limit.

create-article

Create a new article in a specified blog with HTML content, author, tags, and publication status.

update-article

Update article fields including title, body, summary, tags, and author.

get-article-by-id

Fetch a specific article with its details including blog association.

get-pages

List or search pages with summary and timestamps.

update-page

Update a page’s title, body, HTML content, and SEO metadata.

get-pages

List or search pages with summary and timestamps.