Shopify Store Ops
Provides tools to create Gmail drafts and list/get Gmail threads; used for where-is-my-order replies, wholesale order emails, cancellation requests, and VIP customer outreach.
Provides tools to append, get, and update Google Sheets values; used for supplier purchase-order sheets, stock counts, daily sales logs, VIP lists, and combined revenue reporting.
Provides a tool to create Linear issues; used to turn fulfillment exceptions into ops issues.
Provides tools for Shopify products, inventory levels, orders, fulfillment orders, customers, draft orders, locations, cancellations, and inventory adjustments; supports reorders, sales digests, order-status replies, catalogue imports, wholesale draft orders, VIP outreach, and fulfillment exceptions.
Provides a tool to post Slack messages; used for daily sales digests, competitor price alerts, new product notifications, and fulfillment exception alerts.
Provides a tool to list Stripe balance transactions; used to combine Shopify and Stripe revenue into one sheet.
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 Ops answer today's where-is-my-order emails with real fulfillment status"
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.
Shopify Store Ops
Low-stock reorders, where-is-my-order replies, daily sales digests and catalogue imports.
An MCP server with 12 workflows across Shopify, Google Sheets, Gmail, Slack, Firecrawl, Linear and Stripe. Each workflow is a prompt your agent runs as a slash command, over the 26 tools it needs and no others.
uv tool install https://github.com/r28ai/shopify-ops-mcp/releases/download/v0.1.0/shopify_ops_mcp-0.1.0-py3-none-any.whl
claude mcp add shop -- shopify-ops-mcpIt installs with uv from this repository's release, with no git and nothing to build; nothing but Charter and the libraries it uses comes from PyPI. To update, run the install line from the latest release. If a desktop app cannot find shopify-ops-mcp, give it the full path from which shopify-ops-mcp (where shopify-ops-mcp on Windows).
Then ask your agent to connect your apps, or run /mcp__shop__setup.
Connect your apps
Ask the agent to connect one ("connect Linear"). It tells you where to get that app's key and the command that stores it, and the next call works, with no restart. The agent never asks for a key in the chat.
Or connect everything this server uses from a terminal:
shopify-ops-mcp login # each app in turn
shopify-ops-mcp login shopify # just one
shopify-ops-mcp status # what is connectedTokens and keys go to your operating system's keychain (macOS Keychain, Windows Credential Manager, the Secret Service on Linux), and are checked with one read-only call to the app's own API before they are kept. Every key, token and OAuth client is yours: we register no app with any of these services, and nothing passes through a server of ours, because there isn't one.
App | How it connects | Or set |
Shopify | Your own key (get one), entered once. |
|
Browser sign-in, over your own OAuth client (make one). |
| |
Slack | Your own key (get one), entered once. A bot token from your own Slack app, which the guide sets up in about three minutes. |
|
Firecrawl | Your own key (get one), entered once. |
|
Linear | Your own key (get one), entered once. |
|
Stripe | Your own key (get one), entered once. |
|
A variable set in your client's config always wins over the keychain.
Related MCP server: Commerce-MCP
Workflows
Workflow | What you get | Apps |
Low stock → supplier PO draft | Reorders drafted before a bestseller goes out of stock. | Shopify, Google Sheets, Gmail |
Daily sales digest | Yesterday's orders, revenue and top products, posted and logged. | Shopify, Google Sheets, Slack |
Where-is-my-order replies | The commonest support email answered with the actual fulfillment status. | Gmail, Shopify |
Competitor product price watch | A competitor undercuts a SKU and you see both prices side by side. | Firecrawl, Shopify, Slack |
Supplier sheet → new products | A season's catalogue goes from spreadsheet to store draft in one run. | Google Sheets, Shopify, Slack |
Product copy from the supplier's page | Specs and materials pulled from the manufacturer, written as your listing. | Firecrawl, Shopify |
Wholesale order by email → draft order | B2B buyers email a list and get an invoice link back. | Gmail, Shopify |
Cancellation request handled | Unfulfilled orders cancelled on request with the confirmation drafted. | Gmail, Shopify |
VIP customer outreach | Top spenders get a personal note before a launch, not a blast. | Shopify, Google Sheets, Gmail |
Fulfillment exceptions | Orders unfulfilled after 48 hours become an ops issue with the order attached. | Shopify, Linear, Slack |
Stock count from a sheet | The warehouse's count becomes the store's inventory without manual edits. | Google Sheets, Shopify |
Shopify + Stripe revenue in one sheet | Stores selling in two places see one revenue number. | Shopify, Stripe, Google Sheets |
Every prompt takes one optional argument, details: the repo, team, channel, customer or date range you mean, so the agent does not have to ask. In Claude Code, put it in quotes, or only its first word arrives:
/mcp__shop__low_stock_to_supplier_po_draft "anything under 10 units, supplier sheet 'POs'"Reads run without asking. Before anything that creates, sends, changes or deletes, the prompt tells the agent to show you the call and wait.
3 of the 12 workflows need no Google or Granola credential.
Other clients
Claude Desktop: install uv if you have not, since Claude Desktop starts the server with it, then open the .mcpb from the latest release. Claude asks for any keys in its own settings and keeps them in your keychain. The first start takes a few seconds longer, while uv installs it.
VS Code (.vscode/mcp.json): VS Code asks for each key the first time the server starts and stores it securely. Leave out any you stored with login.
{
"inputs": [
{
"type": "promptString",
"id": "shopify-client-secret",
"description": "Shopify: App client secret",
"password": true
},
{
"type": "promptString",
"id": "google-client-secret",
"description": "Google: OAuth client secret",
"password": true
},
{
"type": "promptString",
"id": "slack-bot-token",
"description": "Slack: Bot token (xoxb-\u2026)",
"password": true
},
{
"type": "promptString",
"id": "firecrawl-api-key",
"description": "Firecrawl: API key",
"password": true
},
{
"type": "promptString",
"id": "linear-api-key",
"description": "Linear: Personal API key",
"password": true
},
{
"type": "promptString",
"id": "stripe-api-key",
"description": "Stripe: Secret or restricted key",
"password": true
}
],
"servers": {
"shop": {
"type": "stdio",
"command": "shopify-ops-mcp",
"env": {
"SHOPIFY_CLIENT_SECRET": "${input:shopify-client-secret}",
"GOOGLE_CLIENT_SECRET": "${input:google-client-secret}",
"SLACK_BOT_TOKEN": "${input:slack-bot-token}",
"FIRECRAWL_API_KEY": "${input:firecrawl-api-key}",
"LINEAR_API_KEY": "${input:linear-api-key}",
"STRIPE_API_KEY": "${input:stripe-api-key}",
"SHOPIFY_SHOP": "",
"SHOPIFY_CLIENT_ID": "",
"GOOGLE_CLIENT_ID": ""
}
}
}
}Cursor (.cursor/mcp.json) starts it the same way:
{
"mcpServers": {
"shop": {
"command": "shopify-ops-mcp"
}
}
}Codex (~/.codex/config.toml) starts a turn without waiting for a server unless it is required, and then the agent has none of its tools. required = true makes the session wait for it, and startup_readiness = "catalog" waits for its tool list rather than just its connection:
[mcp_servers.shop]
command = "shopify-ops-mcp"
required = true
startup_readiness = "catalog"
startup_timeout_sec = 30Name the server shop. A host builds each tool's name from that key, and a longer one can push a tool past the 64 characters a function name allows.
Built with Charter
Every tool here is a Charter declaration: a Pydantic schema saying where each field goes on the wire. Charter's runtime builds the request, attaches and refreshes the credential, and trims the response before the model reads it. It runs in your process, with no proxy and no telemetry.
The 26 tool schemas come to 25,389 tokens.
The same tools work in your own agent, without MCP:
from charter.adapters.openai import to_openai_tools
from charter_packs_mcp import FAMILIES
tools = FAMILIES["commerce"].tools()
definitions = to_openai_tools(tools) # or charter.adapters.langchainNeed an API that isn't here? Write a pack: your coding agent writes the declarations, and Charter's conformance suite checks them.
Shopify:
shopify_products_list,shopify_variant_inventory_level,shopify_orders_list,shopify_order_fulfillment_orders,shopify_product_get,shopify_product_create,shopify_product_variants_bulk_create,shopify_product_update,shopify_customers_list,shopify_draft_order_create,shopify_order_get,shopify_order_cancel,shopify_locations_list,shopify_inventory_adjust_quantitiesGoogle Sheets:
gsheets_spreadsheets_values_append,gsheets_spreadsheets_values_get,gsheets_spreadsheets_values_updateGmail:
gmail_drafts_create,gmail_threads_list,gmail_threads_getSlack:
slack_chat_post_messageFirecrawl:
firecrawl_monitor_create,firecrawl_extract,firecrawl_scrapeLinear:
linear_issue_createStripe:
stripe_balance_transactions_list
License
Apache 2.0.
Available Tools
28 toolsconnectA
Connect one app this server uses. For an app that issues keys, says where to get one and the terminal command that stores it. For Google, once the user's own OAuth client is set, starts the browser sign-in and returns at once: the user approves in the browser and the next call works. To see which apps are connected, call connection_status. Never ask the user for a key in the chat.
Inputs: app (required).
connection_statusARead-only
See which apps this server is connected to, and how to connect each one that is not. Changes nothing.
Inputs: no named parameters.
firecrawl_extractA
Extract structured data from one or more URLs using an LLM. Poll results with extract_status.
Inputs: urls (required), prompt, schema, showSources, +6 more.
firecrawl_monitor_createB
Create a scheduled monitor for scrape, crawl, or search targets.
Inputs: name (required), targets (required), schedule (required), goal, +4 more.
firecrawl_scrapeB
Scrape a single URL and optionally extract information. Use when the user wants to read or summarize a specific webpage. Supports markdown, HTML, screenshots, and structured JSON extraction.
Inputs: url (required), proxy, maxAge, minAge, +22 more.
gmail_drafts_createC
Save an email draft to Gmail.
Inputs: body (required), userId.
gmail_threads_getCRead-onlyIdempotent
Read a Gmail thread.
Inputs: id (required), format, userId, metadataHeaders.
gmail_threads_listCRead-onlyIdempotent
List Gmail threads.
Inputs: q, userId, labelIds, pageToken, +2 more.
gsheets_spreadsheets_values_appendC
Appends values to a spreadsheet.
Inputs: range (required), valueRange (required), spreadsheetId (required), valueInputOption (required), +4 more.
gsheets_spreadsheets_values_getCRead-onlyIdempotent
Returns a range of values from a spreadsheet.
Inputs: range (required), spreadsheetId (required), majorDimension, valueRenderOption, +1 more.
gsheets_spreadsheets_values_updateC
Sets values in a range of a spreadsheet.
Inputs: range (required), valueRange (required), spreadsheetId (required), valueInputOption (required), +3 more.
linear_issue_createA
Create an issue. team_id and title are required; everything else is optional. The UUIDs for team, assignee, state and labels come from teams_list, users_list and workflow_states_list — Linear does not accept names here. Set parent_id to create a sub-issue.
Inputs: variables (required).
shopify_customers_listBRead-onlyIdempotent
List customers. Narrow with a Shopify search string in query, e.g. 'email:ada@example.com' or 'orders_count:>5'.
Inputs: variables.
shopify_draft_order_createA
Create a draft order, the way to build an order by hand before it is placed. A draft holds no inventory until it is completed.
Inputs: variables (required).
shopify_inventory_adjust_quantitiesA
Move stock by a relative amount: delta of 5 adds five, -5 removes five. This is not a way to set an absolute count. Every change must also carry change_from_quantity, the count you expect to be overwriting — read it with variant_inventory_level immediately before — so two adjustments racing each other cannot both win. committed is never writable, and on_hand cannot be named here although adjusting available moves it by the same delta. The result reports the deltas applied and leaves quantity_after_change null, so read the level back for the new count. Since 2026-04 adjusting an item that is not stocked at the location succeeds and creates an inactive level, so a success does not prove the stock is sellable.
Inputs: variables (required).
shopify_locations_listBRead-onlyIdempotent
List the store's locations. Inactive ones are excluded unless asked for.
Inputs: variables.
shopify_order_cancelA
Cancel an order. restock has to be stated: true returns the items to inventory, false leaves stock as it is. Shopify does this in the background and answers with a job, so no errors means accepted rather than finished. Cancelling cannot be undone.
Inputs: variables (required).
shopify_order_fulfillment_ordersARead-onlyIdempotent
List an order's fulfillment orders, which is the first half of fulfilling it. Shopify creates these itself, and fulfillment_create names them. The location is at assignedLocation.location.id.
Inputs: variables (required).
shopify_order_getARead-onlyIdempotent
Get one order with its line items, shipping address and totals. Takes a global ID (gid://shopify/Order/...), which orders_list returns.
Inputs: variables (required).
shopify_orders_listARead-onlyIdempotent
List orders. Narrow with a Shopify search string in query, e.g. 'financial_status:paid fulfillment_status:unshipped' to find orders waiting to ship. Only the last 60 days of orders are visible unless this app holds Shopify's read_all_orders scope, and older orders are absent rather than reported — do not read an empty result as an empty history.
Inputs: variables.
shopify_product_createA
Create a product. Only title is required. Note that Shopify creates products unpublished — a new product is not on the storefront until it is published to a sales channel, which is a separate operation.
Inputs: variables (required).
shopify_product_getARead-onlyIdempotent
Get one product with its description and its first 50 variants, including each variant's SKU, price and inventory. Takes a global ID (gid://shopify/Product/...), not a bare number.
Inputs: variables (required).
shopify_products_listBRead-onlyIdempotent
List products. Narrow with a Shopify search string in query, e.g. 'status:active vendor:Acme' or 'inventory_total:<5'.
Inputs: variables.
shopify_product_updateA
Update a product. id is required; only the other fields provided are changed. Note that tags replaces the product's tags rather than adding to them.
Inputs: variables (required).
shopify_product_variants_bulk_createA
Add variants to a product. The SKU goes inside inventory_item, not on the variant. When the product still carries its default placeholder variant, pass the strategy that removes it.
Inputs: variables (required).
shopify_variant_inventory_levelARead-onlyIdempotent
Read a variant's stock at one location. Returns null where the variant is not stocked there, which is not an error.
Inputs: variables (required).
slack_chat_post_messageA
Send a message to a Slack channel, private group, or DM. Provide text for a plain message; set thread_ts to reply inside an existing thread.
Inputs: channel (required), text, parse, blocks, +13 more.
stripe_balance_transactions_listARead-onlyIdempotent
List every movement across the Stripe balance: charges, refunds, fees and payouts. For accounting, reporting_category on each result groups them better than type does.
Inputs: type, limit, payout, source, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 28 tools
Tools are grouped by resource+action and mostly distinct: Shopify product/order/customer/inventory/location tools don't overlap, and read vs write inventory tools are clearly separated. Minor overlap between firecrawl_scrape and firecrawl_extract (both can extract structured JSON) and the broad multi-domain span makes cross-app selection occasionally ambiguous, but descriptions disambiguate well.
A predictable domain_resource_action pattern runs throughout (shopify_products_list, shopify_product_get, gmail_threads_get, stripe_balance_transactions_list). The only real deviations are the un-prefixed connect and connection_status utilities, which break the otherwise consistent scheme.
28 tools is heavy, and they are split across eight unrelated services (Shopify, Sheets, Gmail, Slack, Firecrawl, Linear, Stripe, connection management), leaving each app with only a few operations. It is defensible for a multi-app integration server but sits above the comfortable range for a Shopify-centric 'Store Ops' surface.
Core Shopify read/write flows (products, orders, inventory, locations) are covered, but there are notable gaps: no product delete, no order fulfillment creation even though shopify_order_fulfillment_orders' description references a nonexistent fulfillment_create, Gmail cannot send (draft only), and Slack only posts. These leave some obvious dead ends an agent would hit.
Maintenance
Related MCP Connectors
Run your Shopify store with AI: drafts you approve, what to fix, and how your store is doing.
Launch and manage online stores with AI agents: products, inventory, pricing, orders and promotions.
Post to social media, run Google Ads, manage Shopify, inventory and phone calls from your AI.
Create invoices, clients, and Stripe payment links from any agent. 7 tools. No email or deletes.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceA production-grade MCP server and CLI tool that enables AI agents to manage Shopify stores through 49 built-in tools across products, orders, inventory, and analytics. It supports natural language workflows for tasks like inventory tracking, customer support, and sales reporting.888 npm18MIT
- AlicenseDqualityDmaintenanceEnables natural-language control of e-commerce operations including product management, order processing, inventory tracking, customer service, content generation, and advertising analytics through 15 integrated MCP tools. Provides a local-first commerce automation solution with SQLite storage and extensible channel adapters for end-to-end online store workflows.153MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to manage Shopify stores via natural language, with tools for products, orders, inventory, customers, and analytics.11 npmMIT
- AlicenseBqualityBmaintenanceRuns 20 slash-command workflows across Google Calendar, Gmail, Linear, Slack, Granola, Google Docs, GitHub, Stripe, Notion, Google Forms, Sheets and Drive to produce morning briefs, meeting prep, action items assigned to owners and weekly updates. Reads proceed without asking, while anything that creates, sends, changes or deletes is shown for approval first.471Apache 2.0