shopify-store-builder-mcp
MCP server for administering a single Shopify store and/or Horoshop store directly from your MCP client, with credentials kept in your local client config.
Shop info —
shop_get_inforeads store name, domain, currency, plan.Shopify themes —
theme_list,theme_read_file,theme_update_file; README adds import/duplicate/publish, plus a live-theme guard requiring approval andconfirmLiveTheme: true.Shopify pages —
page_list,page_create(unpublished draft unlessisPublished),page_update(title, body, handle, publish status).Shopify menus —
menu_list,menu_update(destructive full replace: omitted items are deleted, so pass existing item IDs).Shopify theme media — find image/video picker slots in a template, upload a local image/MP4 to Shopify Files, poll processing status, then set one slot.
Shopify products — list/get/create/update/delete, draft creation with image URLs, add images from URLs or local files, media status, variants and price updates, inventory locations and available quantities.
Shopify customers/orders — profile CRUD, purchase history, order CRUD/cancel, line items, fulfillment orders, create fulfillment, bounded order summary.
Shopify discounts — code discounts (percentage or fixed) and automatic discounts, list/create/update/delete.
Shopify analytics —
shopify_sales_reportvia ShopifyQL (sales, orders, discounts, AOV by day/month/total).Horoshop — categories, product list/create/update (with image galleries), product reviews (scrapes schema.org/Review, headless Chrome fallback, max 100), customer upsert, purchase history by delivery email, orders list/statuses/update, and order summary with currency, status, and UTM breakdowns.
Not covered — Shopify refunds, partial fulfillment, line-item edits, advanced discounts; Horoshop customer deletion and order creation/deletion.
Provides tools for building and managing Shopify stores, including editing themes, pages, and navigation menus via the Shopify Admin API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@shopify-store-builder-mcp update the homepage banner text to 'Grand Opening'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
EasyCRM MCP
An MCP server for one Shopify store and one Horoshop store. Tools are grouped by platform and resource so each action has a clear destination and input contract.
The server runs locally and sends requests directly to each configured platform. Credentials stay in your MCP client configuration on your machine.
Quick start
https://github.com/user-attachments/assets/ab10078a-c557-4f72-b37a-1958c3991029
npx -y easycrm-mcp initTo run the setup wizard directly from a repository checkout, use npm ci and npm run dev -- init.
The wizard lets you configure Shopify, Horoshop, or both. It verifies each connection and registers the server in the client you pick:
Claude Code
Codex CLI
Gemini CLI
Claude Desktop
Cursor
Windsurf
VS Code (Copilot)
Pick "Other" to print a config entry for any other MCP client.
Related MCP server: MCP Shopify
Store credentials
Shopify
You need a store on a plan with Admin API access and one of:
Option A: Dev Dashboard app (for stores in your own Shopify organization)
Go to dev.shopify.com/dashboard and create an app for a store in your organization. Shopify limits client credentials to stores in your own organization.
Grant only the scopes needed for the tools you plan to use:
Resource
Read
Write
Themes
read_themeswrite_themesShopify Files for theme media
read_fileswrite_filesPages
read_contentwrite_contentMenus
read_online_store_navigationwrite_online_store_navigationProducts and variants
read_productswrite_productsInventory
read_inventory,read_locationswrite_inventoryCustomers
read_customerswrite_customersOrders
read_orderswrite_ordersFulfillment orders
Matching assigned, merchant-managed, or third-party fulfillment read scope
Matching fulfillment write scope
Discounts
read_discountswrite_discountsNative sales reports
read_reportsNone
Shopify customer data also requires protected customer data approval. Orders older than 60 days normally require
read_all_orders. Some actions require additional staff permissions or an offline token. The individual tool descriptions state these cases. The native Shopify sales report requires Level 2 protected customer data access, as documented forshopifyqlQuery.Copy the Client ID and Client Secret from the app's settings.
Option B: existing admin access token
Use an existing shpat_… token from an admin-created custom app. Shopify no longer allows creating new admin-created custom apps.
Editing theme files requires Shopify's write_themes exemption in addition to the API scope. See Shopify's themeFilesUpsert requirements.
Horoshop
Create a dedicated API admin login in the Horoshop admin panel under Settings > Admins. Configure the store's HTTPS origin, login, and password. Horoshop issues an API token valid for 600 seconds; this server renews it automatically. See the official Horoshop API documentation and authentication details.
Manual configuration
If you skip the wizard, add this to your MCP client's config:
{
"easycrm": {
"command": "npx",
"args": ["-y", "easycrm-mcp"],
"env": {
"SHOPIFY_STORE_DOMAIN": "your-store.myshopify.com",
"SHOPIFY_CLIENT_ID": "…",
"SHOPIFY_CLIENT_SECRET": "…",
"HOROSHOP_STORE_URL": "https://shop.example.com",
"HOROSHOP_LOGIN": "your_api_login",
"HOROSHOP_PASSWORD": "…"
}
}
}You can configure either platform by omitting the other platform's variables. For Shopify, you can use an existing access token instead of client credentials by setting SHOPIFY_ADMIN_ACCESS_TOKEN.
Tools
Shopify
Tool | What it does |
| Read Shopify store name, domain, plan, currency |
| List Shopify themes |
| Identify the current live MAIN theme |
| Import a theme ZIP as unpublished |
| Copy an existing theme into an unpublished draft |
| Publish a theme after confirming the current MAIN theme and user approval |
| Read a Shopify theme file |
| Create or update a theme file, with a live-theme guard |
| Find image and video picker settings in a theme JSON template, section group, or global settings |
| Upload a local image or MP4 video into Shopify Files |
| Check media processing and get its theme reference |
| Fill or replace one selected theme media setting with a ready file |
| List Shopify pages |
| Create a Shopify page |
| Update a Shopify page |
| List Shopify menus |
| Replace a Shopify menu |
| Manage core product fields |
| Create an unpublished product and submit image URLs, optionally setting its first price |
| Add images to an existing product |
| Upload a local image and attach it to an existing product |
| Check image processing status and URLs |
| Read variants and change a price |
| Find inventory locations |
| Read available quantity by location |
| Set available quantity with a comparison value and idempotency key |
| Manage customer profiles |
| Read a customer's orders and purchased items by customer ID |
| Manage orders within Shopify's operation rules |
| Page through purchased items in one order |
| Find fulfillable units for an order |
| Fulfill one entire fulfillment order |
| Compute a bounded order summary from accessible orders |
| Read native Shopify Analytics sales metrics by day, month, or total |
| Manage basic code discounts by percentage or fixed amount |
| Manage basic automatic discounts |
Horoshop
Tool | What it does |
| Read child categories under a parent |
| Read products, optionally filtered by article (SKU) |
| Read public product reviews and load more batches when available |
| Create a product in a selected category with optional images |
| Update an existing product's price, text, visibility, warehouse stock, or images |
| Create or update one customer by email |
| Find orders and purchased products by delivery email |
| Read paged orders with optional date and status filters |
| Read configured order status IDs |
| Set one order's status or payment flag |
| Compute bounded counts and totals from orders in a date range |
Each tool is tied to one configured platform. Horoshop product creation accepts image URLs for a variant gallery or a shared gallery. Image updates require an explicit append or replace mode; replace removes the existing images in that gallery. Horoshop fetches images from the supplied URLs, with a 5 MB limit for each source image. The product list supports offset and limit for paging, with a maximum of 500 products per request per the Horoshop export API. Horoshop category export requires platform version 4 or later.
horoshop_product_reviews accepts a product URL or path on the configured store. It reads public schema.org/Review markup, including reviews without star ratings. It tries a plain HTTP request first. For a JavaScript challenge or additional review batches, it opens a temporary headless Chrome session and closes it after the read. Chrome must be installed locally; no browser is downloaded with this package. Set HOROSHOP_BROWSER_EXECUTABLE_PATH if Chrome is installed in a nonstandard location. maxReviews defaults to 20 and is capped at 100. totalCount reflects the page's review count, and complete: false means more reviews may exist. The tool does not read private or unpublished reviews.
Before editing theme files, call shopify_theme_active or shopify_theme_list. The update tool checks the observed role again. Editing the live MAIN theme requires explicit user approval and confirmLiveTheme: true; publishing requires approval, confirmPublish: true, and the expected current MAIN theme ID. Draft themes can be edited without changing the live storefront. Shopify requires a theme API exemption for theme mutations.
To change a theme banner image or video, inspect its settings with shopify_theme_media_slots using the relevant template path, for example templates/index.json. The result identifies section, block, and setting IDs, including empty media pickers. Upload a local file with shopify_theme_media_upload_local, wait for shopify_theme_media_file_status to report READY, then call shopify_theme_media_set with the returned file ID and the slot's observed value. The setter checks the theme schema and current value again, and changes only that setting. Images may be PNG, JPEG, WebP, or GIF up to 20 MB. Video upload currently supports MP4 up to 1 GB and streams the local file. The file path is read on the machine running the MCP server. video_url settings for YouTube or Vimeo are separate from Shopify-hosted video pickers and are not handled by this flow. A concurrent Theme Editor save during the final theme file write can still overwrite changes because Shopify does not offer an atomic compare-and-swap for theme JSON files.
Shopify product images can be submitted from public HTTPS URLs or local files. The local-image tool accepts an absolute path on the MCP server machine and uploads one PNG, JPEG, WebP, or GIF up to 20 MB through Shopify staging before attaching it to the product. Shopify processes images asynchronously, so use shopify_product_media_list to check readiness. Creating a draft with an initial price uses a second mutation for the default variant. If that step fails, the tool returns the created product ID and marks the partial result as an error.
Analytics
shopify_sales_reportreads native Shopify Analytics through ShopifyQL. Select a date range, total/daily/monthly interval, and metrics such as sales, orders, discounts, and average order value. This requiresread_reportsand Level 2 protected customer data access.shopify_order_summarycalculates order counts and current order totals from accessible orders. It reportspaginationCompleteand a cursor when it stops before the last page.horoshop_order_summarycalculates order counts, paid counts, totals by currency, and breakdowns by status and UTM source from the Horoshop orders API. Currency totals are exact decimal strings, for example"0.3". It scans at most 5,000 orders and reportscomplete: falseif more may exist.
The two order summaries are calculated from API orders, not native analytics reports or settled payment revenue. Horoshop total_sum includes discounts and excludes shipping. The server does not currently expose traffic, sessions, or conversion funnel analytics for Horoshop.
Purchase history
Both purchase history tools read store data through the configured API connection. Shopify searches orders by customer ID, newest first, and returns an order cursor for the next page. Each order includes up to 20 line items; when itemsComplete is false, pass nextItemsCursor and the order ID to shopify_order_line_items to read more. Shopify normally limits order access to the most recent 60 days unless the app has read_all_orders.
Horoshop has no documented customer filter for orders/get, so horoshop_customer_purchase_history scans up to maxPages pages of 100 orders, matching delivery_email exactly without regard to letter case. Use from and to to narrow the search. If complete is false, pass nextOffset as offset in another call to continue. An empty result with complete: false does not establish that the customer has no earlier purchases.
The current tools do not cover every action in either admin. In particular, Shopify refunds, partial fulfillment, edits to line items, advanced discount types, and Horoshop customer deletion or order creation/deletion need separate workflows and API verification. Shopify cancellation returns a job ID because processing is asynchronous. See the architecture notes for the extension plan.
Moving from the Shopify-only package
The previously published shopify-store-builder-mcp package remains available. To use this package, replace the npm command with easycrm-mcp, use the new easycrm MCP entry, and update tool names to their shopify_ versions. Horoshop variables can then be added to the same entry.
Development
npm install
npm run dev # run from source
npm run build # compile to dist/
npm test
npm auditLicense
ISC
Available Tools
9 toolspage_createCreate pageA
Create a new page in the Shopify store. Pages are created as unpublished drafts unless isPublished is true.
Inputs: title (required), body, handle, isPublished.
page_listList pagesARead-only
List the store's pages with their GIDs, handles, and publish status. Use the id from here for page_update.
Inputs: no named parameters.
page_updateUpdate pageADestructive
Update an existing page's title, body, handle, or publish status. Only provided fields change. Get the page GID from page_list.
Inputs: id (required), body, title, handle, +1 more.
shop_get_infoGet shop infoARead-only
Get basic info about the connected Shopify store: name, domain, currency, plan.
Inputs: no named parameters.
theme_listList themesARead-only
List the store's themes with their GIDs and roles. Role MAIN is the published live theme. Use the id from here for theme_read_file and theme_update_file.
Inputs: no named parameters.
theme_read_fileRead theme fileARead-only
Read the content of one file in a Shopify theme. Get the theme ID from theme_list first.
Inputs: themeId (required), filePath (required).
theme_update_fileUpdate theme fileADestructive
Overwrite one file in a Shopify theme with new content. Get the theme ID from theme_list first.
Inputs: themeId (required), filePath (required), fileContent (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a distinct resource and action: pages, menus, themes, and shop info. The relationships between list/get and update/create tools are clearly documented, leaving no ambiguity about which tool to use for a given task.
All tool names follow a consistent verb_noun pattern using lowercase and underscores (page_list, menu_update, theme_read_file). The pattern is uniform across all nine tools, making them predictable and easy to navigate.
With 9 tools, the server is well-scoped for managing pages, menus, themes, and shop info. This is a reasonable number that covers the core store-building functionality without unnecessary bloat or sparse coverage.
The toolset covers the main lifecycle for pages (list, create, update) and themes (list, read, update), plus menu replacement and shop info. Minor gaps exist (e.g., no delete operations for pages or menus, no theme creation), but the core workflows for customizing a storefront are covered.
Related MCP Connectors
Hosted Shopify MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Build, deploy and manage MaShop e-commerce projects from Claude, Cursor or any MCP client.
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
Hosted Magento MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for Shopify Admin API with a ComfyUI bridge for AI product image generation. Covers products, orders, inventory, and customers.5849 npm1MIT
- AlicenseNot gradedqualityCmaintenanceA comprehensive MCP server for Shopify Admin API integration, enabling AI assistants to manage products, orders, customers, inventory, analytics, and more through natural language.19 npm20MIT
- AlicenseNot gradedqualityDmaintenanceProduction-grade MCP server for the Shopify Admin GraphQL API, exposing typed tools for AI agents to manage products, orders, customers, and more.Business Source 1.1
- AlicenseCqualityDmaintenanceMCP server for Shopify Admin API. Enables product, order, customer, and inventory management via natural language.147 npm1MIT