Skip to main content
Glama

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-mcp

It 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 connected

Tokens 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.

SHOPIFY_SHOP, SHOPIFY_CLIENT_ID, SHOPIFY_CLIENT_SECRET

Google

Browser sign-in, over your own OAuth client (make one).

GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET

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.

SLACK_BOT_TOKEN

Firecrawl

Your own key (get one), entered once.

FIRECRAWL_API_KEY

Linear

Your own key (get one), entered once.

LINEAR_API_KEY

Stripe

Your own key (get one), entered once.

STRIPE_API_KEY

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 low_stock_to_supplier_po_draft

Reorders drafted before a bestseller goes out of stock.

Shopify, Google Sheets, Gmail

Daily sales digest daily_sales_digest

Yesterday's orders, revenue and top products, posted and logged.

Shopify, Google Sheets, Slack

Where-is-my-order replies where_is_my_order_replies

The commonest support email answered with the actual fulfillment status.

Gmail, Shopify

Competitor product price watch competitor_product_price_watch

A competitor undercuts a SKU and you see both prices side by side.

Firecrawl, Shopify, Slack

Supplier sheet → new products supplier_sheet_to_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 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 wholesale_order_by_email_to_draft_order

B2B buyers email a list and get an invoice link back.

Gmail, Shopify

Cancellation request handled cancellation_request_handled

Unfulfilled orders cancelled on request with the confirmation drafted.

Gmail, Shopify

VIP customer outreach vip_customer_outreach

Top spenders get a personal note before a launch, not a blast.

Shopify, Google Sheets, Gmail

Fulfillment exceptions fulfillment_exceptions

Orders unfulfilled after 48 hours become an ops issue with the order attached.

Shopify, Linear, Slack

Stock count from a sheet 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 shopify_and_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 = 30

Name 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.langchain

Need 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_quantities

  • Google Sheets: gsheets_spreadsheets_values_append, gsheets_spreadsheets_values_get, gsheets_spreadsheets_values_update

  • Gmail: gmail_drafts_create, gmail_threads_list, gmail_threads_get

  • Slack: slack_chat_post_message

  • Firecrawl: firecrawl_monitor_create, firecrawl_extract, firecrawl_scrape

  • Linear: linear_issue_create

  • Stripe: stripe_balance_transactions_list

License

Apache 2.0.

Available Tools

28 tools
connectA

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_statusA
Read-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_getC
Read-onlyIdempotent

Read a Gmail thread.

Inputs: id (required), format, userId, metadataHeaders.

gmail_threads_listC
Read-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_getC
Read-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_listB
Read-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_listB
Read-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_ordersA
Read-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_getA
Read-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_listA
Read-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_getA
Read-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_listB
Read-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_levelA
Read-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_listA
Read-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

    B3.3/5.0

    Scored across 28 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count3/5

    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.

    Completeness3/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      A 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 npm
      18
      MIT
    • A
      license
      D
      quality
      D
      maintenance
      Enables 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.
      15
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to manage Shopify stores via natural language, with tools for products, orders, inventory, customers, and analytics.
      11 npm
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Runs 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.
      47
      1
      Apache 2.0