# ShopMCP

> ShopMCP is a Shopify MCP (Model Context Protocol) connector that gives Claude direct read and write access to a Shopify store. Store owners and agencies can manage their entire Shopify store through natural language — no coding, no developer needed.

## What ShopMCP is

ShopMCP connects Claude to a Shopify store via the MCP standard. Once connected, Claude can edit theme files, create landing pages, rewrite product descriptions, manage blog content, update navigation menus, and more — publishing changes live to the store in seconds.

It is built on the Shopify GraphQL Admin API (2025-01) and communicates using HTTP Streamable JSON-RPC 2.0.

- Website: https://www.shopmcp.net
- Install: https://apps.shopify.com/pricebeat
- YouTube: https://www.youtube.com/@AnderseenDigital
- Getting started: https://www.shopmcp.net/getting-started.aspx
- What you can do: https://www.shopmcp.net/what-you-can-do.aspx
- Pricing: https://www.shopmcp.net/#pricing

## Pricing

- Lite plan: $4.90/month
- Basic plan: $9.90/month
- 30-day free trial on all plans
- No credit card required to start
- Cancel any time from Shopify admin

## Who it is for

- Shopify store owners who want to make changes without a developer
- Shopify agencies and freelancers managing multiple client stores
- Anyone using Claude who wants to connect it to a live Shopify store

## How to set it up

1. Install ShopMCP from the Shopify App Store (free, 30-day trial)
2. Open ShopMCP settings and copy your personal MCP URL
3. Add the URL as a connector in Claude Desktop or Claude.ai
4. Start a conversation — Claude is now connected to your store

Setup takes under 5 minutes. Full walkthrough at https://www.shopmcp.net/getting-started.aspx

## MCP server details

- Transport: HTTP Streamable, JSON-RPC 2.0
- MCP URL format: https://www.shopmcp.net/mcp-shopify.ashx?key=SECRET&aid=ACCOUNT_ID
- Protocol version: 2024-11-05
- Shopify API version: 2025-01 (GraphQL Admin API)
- Each store gets its own secure MCP URL with a unique key

## What Claude can do with ShopMCP connected

### Theme and design
- Read, edit, and publish any theme file (Liquid, CSS, JSON)
- Works with any Shopify theme — Dawn, Prestige, Horizon, custom builds
- Targeted find-and-replace edits on large files without re-uploading
- Append CSS rules or Liquid snippets to existing files
- Copy files between themes (e.g. from backup to live)

### Pages
- Create custom landing pages with Liquid sections and JSON templates
- Update existing pages — title, content, template, URL handle
- Delete pages
- Pages go live immediately at yourstore.com/pages/handle

### Products
- Search and list products by title or SKU
- Read full product details including all variants and images
- Update product title, description (HTML), tags, status, vendor
- Create new products (DRAFT by default, publishable immediately)
- Update variant price, compare-at price, SKU, taxable flag
- Price changes go live immediately — Claude validates input before writing

### Collections
- List all collections with product counts
- Update collection title, description, URL handle

### Blog and articles
- List, create, update, and delete blog posts
- Publish or draft articles
- Multi-blog support

### Navigation menus
- List all menus with full item structure
- Replace menu item lists (supports nested dropdowns)

### AI image generation (optional)
- Generate images via OpenRouter API
- Images uploaded directly to Shopify file library
- Returns permanent Shopify CDN URL for use in Liquid or CSS
- Requires user to provide their own OpenRouter API key

### Store info
- Read store name, domain, currency, timezone, plan

## Tools reference (34 tools)

| Tool | Type | Description |
|---|---|---|
| shopify_preflight | READ | Setup health check — run first in every session |
| shopify_list_themes | READ | List all themes; role=MAIN is the live theme |
| shopify_list_assets | READ | List all file paths in a theme |
| shopify_get_asset | READ | Fetch and cache a theme file for editing |
| shopify_update_asset | WRITE | Publish an edited file to a theme |
| shopify_create_asset | WRITE | Create a new file in a theme |
| shopify_delete_asset | WRITE | Delete a file from a theme |
| shopify_copy_asset | WRITE | Copy a file between themes server-side |
| shopify_patch_asset | WRITE | Find-and-replace inside a cached theme file |
| shopify_append_to_asset | WRITE | Append content to the end of a cached file |
| shopify_get_guide | READ | Fetch a writing or design guide |
| shopify_generate_image | GEN | Generate an AI image and upload to Shopify Files |
| shopify_get_shop_info | READ | Store name, domain, currency, plan |
| shopify_check_network | READ | Check upload server reachability |
| shopify_list_pages | READ | List all Shopify pages |
| shopify_get_page | READ | Fetch a single page by ID |
| shopify_create_page | WRITE | Create a new page in Shopify Online Store |
| shopify_update_page | WRITE | Update title, content, or template of a page |
| shopify_delete_page | WRITE | Delete a page |
| shopify_list_blogs | READ | List all blogs |
| shopify_create_blog | WRITE | Create a new blog |
| shopify_list_articles | READ | List articles in a blog |
| shopify_create_article | WRITE | Create and publish a blog article |
| shopify_update_article | WRITE | Update an existing article |
| shopify_delete_article | WRITE | Delete an article |
| shopify_list_menus | READ | List all navigation menus with item structure |
| shopify_update_menu | WRITE | Replace the full item list of a menu |
| shopify_list_products | READ | Search and list products by title or SKU |
| shopify_get_product | READ | Full product details including variants and images |
| shopify_update_product | WRITE | Update product title, description, tags, status |
| shopify_create_product | WRITE | Create a new product (DRAFT by default) |
| shopify_update_variant | WRITE | Update variant price, compare-at price, SKU |
| shopify_list_collections | READ | List all collections with product counts |
| shopify_update_collection | WRITE | Update collection title, description, handle |

## Known limitations

- templates/index.json on the live theme cannot be written via the Shopify API (Shopify restriction — read-only on live theme homepage template)
- Binary assets (images, fonts) can be listed but not read as text
- All writes are immediate — recommend duplicating the theme before major edits
- Image generation requires a separate OpenRouter API key

## Companion MCP connectors

ShopMCP is part of a growing suite:

- MailFella (https://www.mailfella.com) — email campaign MCP connector
- BrowseMCP (https://www.browsemcp.net) — web research MCP connector

## Built by

Max Anderseen — Shopify Expert, Google Ads Expert, AI Developer
LinkedIn: https://www.linkedin.com/in/anderseen/
YouTube: https://www.youtube.com/@AnderseenDigital