Skip to main content
Glama
Jeanivy

Shopify MCP

by Jeanivy

Shopify MCP

Read-only Shopify Admin API MCP server for Codex business reporting.

The server exposes business-level tools for Codex instead of a raw GraphQL passthrough:

  • get_shop_summary

  • list_recent_orders

  • get_sales_report

  • list_low_inventory_products

  • search_products

Secrets are intentionally not stored in this repository. Each machine must provide its own Shopify Admin API token through SHOPIFY_SECRETS_FILE.

Install

git clone <repo-url> shopify-mcp
cd shopify-mcp
npm install

Create the local secrets file:

mkdir -p ~/.codex/secrets
chmod 700 ~/.codex/secrets
cp .env.example ~/.codex/secrets/hholove-shopify.env
nano ~/.codex/secrets/hholove-shopify.env
chmod 600 ~/.codex/secrets/hholove-shopify.env

Required values:

SHOPIFY_STORE_DOMAIN=64f8b1.myshopify.com
SHOPIFY_ADMIN_ACCESS_TOKEN=<Admin API access token>
SHOPIFY_API_VERSION=2026-04
SHOPIFY_REPORT_TIME_ZONE=Asia/Shanghai

Verify

Run local tests:

npm test

Run live Shopify sanity:

SHOPIFY_SECRETS_FILE="$HOME/.codex/secrets/hholove-shopify.env" \
node scripts/shopify-query.mjs sanity

Run a Shanghai-time daily order check:

SHOPIFY_SECRETS_FILE="$HOME/.codex/secrets/hholove-shopify.env" \
node scripts/shopify-query.mjs recent-orders --today --time-zone Asia/Shanghai

Register With Codex

/Applications/Codex.app/Contents/Resources/codex mcp add hholove-shopify \
  --env SHOPIFY_SECRETS_FILE="$HOME/.codex/secrets/hholove-shopify.env" \
  -- node "$PWD/mcp/hholove-shopify-server.mjs"

Inspect the registration:

/Applications/Codex.app/Contents/Resources/codex mcp get hholove-shopify
/Applications/Codex.app/Contents/Resources/codex mcp list

Restart Codex after changing MCP registration.

The Git repository is named shopify-mcp; the Codex MCP registration name is currently hholove-shopify so it stays paired with the existing store secrets file and local Codex configuration.

Development

npm run test:hholove-shopify-mcp
npm run test:shopify-query
npm run mcp:hholove-shopify

Implementation notes live in mcp/README.md. Target-Mac setup details live in docs/hholove-shopify-mcp-transfer.md.

A
license - permissive license
-
quality - not tested
C
maintenance

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Jeanivy/shopify-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server