Shopify MCP Server For Claude Desktop

🚀 Shopify MCP Server for Claude Desktop

This is a simple Model Context Protocol (MCP) server that connects your Shopify store data to Claude Desktop, allowing Claude to access your store information.

🚀 Quick Start

This MCP server enables Claude Desktop to access your Shopify store data. Follow these steps to set it up:

📦 Installation

1. Install dependencies:

   npm install
   

2. Create a .env file and add your Shopify credentials:

   SHOPIFY_STORE_NAME=your-store-name
   SHOPIFY_API_ACCESS_TOKEN=your-access-token
   

3. Build the TypeScript code:

   npm run build
   

4. Run the MCP server:

   npm start
   

5. In Claude Desktop, set the MCP server to point to this server. Now you should be able to access your Shopify data.

✨ Features

This server provides the following Shopify features through the MCP tool:

Product Tools

• create_product: This tool creates a product structure with options (e.g., color, size) and sets the status to DRAFT. It handles product titles, descriptions, suppliers, types, tags, and option configurations but does not create variants with prices. This is the first step in product creation.

• browse_products: This tool retrieves a list of products, optionally including inventory information. It supports pagination and provides key product details such as titles, descriptions, images, variants, and inventory status. When a specific product_id is provided, it returns detailed information for that single product.

• update_variant_price: This tool updates the price and/or compare-at price of a specific product variant. It can set a new regular price, add/update a compare-at price, or remove the compare-at price by passing null or an empty string.

Inventory Tools

• list_inventory_items: This tool retrieves a list of inventory items, optionally filtered by SKU. It supports pagination and provides inventory details such as available quantity, cost, and inventory locations.

• get_inventory_item: This tool retrieves detailed information about a specific inventory item (by ID or SKU). It returns comprehensive inventory data, including whether it's tracked, available quantity at all locations, and associated variant information.

• update_inventory_quantity: This tool updates the available quantity of an inventory item at a specific location. It accepts the inventory item ID, location ID, and new available quantity and returns the adjusted inventory level.

Order Tools

• browse_orders: This tool retrieves Shopify orders with powerful filtering options. It supports filtering by status, date range, customer email, financial status, and fulfillment status and allows searching by order number or customer details. When a specific order_id is provided, it returns detailed information for that single order.

Customer Tools

• browse_customers: This tool retrieves customer information and spending data with advanced filtering options. It supports sorting by multiple fields, filtering by minimum/maximum spending, and returns detailed customer profiles. When a specific customer_id is provided, it returns comprehensive information for that single customer.

Media Tools

• upload_image_from_url: This tool uploads an image from a public URL to the Shopify CDN file section. It handles transferring the image data to the Shopify server and allows specifying alt text and an optional file name.

Abandonment Tools

• get_abandonment: This tool retrieves detailed information about a specific cart or checkout abandonment. It returns data about the abandoned cart, including items, prices, customer information (if available), and abandonment timing. You can customize the fields returned in the response.

GraphQL Tools

• query_shopify: This tool executes custom GraphQL queries or mutations on the Shopify Admin API. It allows full flexibility to access any Shopify Admin API endpoints not covered by specialized tools and provides options to pass variables and enable mutation operations.

• introspect_admin_schema: This tool introspects and returns the portion of the Shopify Admin API GraphQL schema relevant to the user's prompt. It is only used for the Shopify Admin API, not for any other APIs such as the Shopify Storefront API or Shopify Functions API. It accepts search terms to filter schema elements by name and provides options to focus on specific sections, such as types, queries, or mutations.

📄 License

MIT