{"_id":"@apexradius/shopify-mcp","_rev":"2-b981b775d89c24dd0ebfa7deb7ae92f2","name":"@apexradius/shopify-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@apexradius/shopify-mcp","version":"1.0.0","keywords":["shopify","mcp","model-context-protocol","claude","anthropic","ai","ecommerce"],"author":{"name":"Apex Radius Labs"},"license":"MIT","_id":"@apexradius/shopify-mcp@1.0.0","maintainers":[{"name":"apexradius","email":"apexradiuslabs@gmail.com"}],"homepage":"https://github.com/apexradius/shopify-admin-mcp","bugs":{"url":"https://github.com/apexradius/shopify-admin-mcp/issues"},"bin":{"shopify-mcp":"dist/index.js"},"dist":{"shasum":"5963d8e318373f81376bb422363ff6d82c7c8c26","tarball":"https://registry.npmjs.org/@apexradius/shopify-mcp/-/shopify-mcp-1.0.0.tgz","fileCount":46,"integrity":"sha512-Lh9+utX495+OfWfMgaGWm6+0O+zu2gUP9y4P5nqGOfRCSDu/VvZDUtA7jRHXnA9AkVihtFPgIwwcg7yp0Ami3w==","signatures":[{"sig":"MEQCIFGnKdSboAUEjOo7bLBAdZWdwJsPevl1IZkeu5PbPJtZAiBJbjxSTV3IwW2FqGdPT6cnS9DRIi5MeXtKA6cCU3iZig==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61982},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"1a1ad9cc3bddda216756512af6a6a46e93e19cc7","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"apexradius","email":"apexradiuslabs@gmail.com"},"repository":{"url":"git+https://github.com/apexradius/shopify-admin-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"A Model Context Protocol (MCP) server for Shopify — giving Claude direct access to your store's products, orders, customers, collections, metafields, and themes.","directories":{},"_nodeVersion":"25.8.1","dependencies":{"zod":"^4.3.6","@modelcontextprotocol/sdk":"^1.10.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/shopify-mcp_1.0.0_1775584857600_0.9513327041331519","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-04-07T18:00:57.530Z","modified":"2026-04-12T02:32:20.060Z","1.0.0":"2026-04-07T18:00:57.785Z"},"bugs":{"url":"https://github.com/apexradius/shopify-admin-mcp/issues"},"author":{"name":"Apex Radius Labs"},"license":"MIT","homepage":"https://github.com/apexradius/shopify-admin-mcp","keywords":["shopify","mcp","model-context-protocol","claude","anthropic","ai","ecommerce"],"repository":{"url":"git+https://github.com/apexradius/shopify-admin-mcp.git","type":"git"},"description":"A Model Context Protocol (MCP) server for Shopify — giving Claude direct access to your store's products, orders, customers, collections, metafields, and themes.","maintainers":[{"email":"apexradiuslabs@gmail.com","name":"famuagun"}],"readme":"# @apexradius/shopify-mcp\n\n> **Excellence in every detail.**\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for Shopify — giving Claude and other AI assistants direct, structured access to your store's data.\n\n## Features\n\n| Category | Tools |\n|---|---|\n| **Shop** | Get store info |\n| **Products** | List, get, create, update, count |\n| **Orders** | List, get, update, cancel, count |\n| **Customers** | List, get, search, count |\n| **Collections** | List, get, list products in collection |\n| **Metafields** | List, set, delete (for any resource) |\n| **Themes** | List, get, list/get/update assets |\n| **GraphQL** | Raw GraphQL query/mutation passthrough |\n\n## Requirements\n\n- Node.js 18+\n- A Shopify store with an Admin API access token\n\n## Installation\n\n```bash\nnpm install -g @apexradius/shopify-mcp\n```\n\nOr run directly with npx:\n\n```bash\nnpx @apexradius/shopify-mcp\n```\n\n## Configuration\n\nThe server is configured via environment variables:\n\n| Variable | Required | Description |\n|---|---|---|\n| `SHOPIFY_SHOP_DOMAIN` | Yes | Your store domain (e.g. `my-store.myshopify.com`) |\n| `SHOPIFY_ACCESS_TOKEN` | Yes | Admin API access token |\n| `SHOPIFY_API_VERSION` | No | API version (default: `2025-01`) |\n\n### Getting your access token\n\n1. Go to your Shopify Admin → **Settings** → **Apps and sales channels**\n2. Click **Develop apps** → **Create an app**\n3. Under **Configuration**, grant the API scopes you need\n4. Under **API credentials**, install the app and copy the **Admin API access token**\n\n**Recommended scopes:** `read_products`, `write_products`, `read_orders`, `write_orders`, `read_customers`, `read_inventory`, `read_themes`, `write_themes`, `read_metaobjects`, `write_metaobjects`\n\n## Claude Desktop / Claude Code Setup\n\nAdd to your `~/.mcp.json` or Claude Desktop config:\n\n```json\n{\n  \"mcpServers\": {\n    \"shopify\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@apexradius/shopify-mcp\"],\n      \"env\": {\n        \"SHOPIFY_SHOP_DOMAIN\": \"your-store.myshopify.com\",\n        \"SHOPIFY_ACCESS_TOKEN\": \"shpat_xxxxxxxxxxxxxxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n### Shop\n- `shopify_get_shop` — Get store info (name, email, currency, timezone, plan)\n\n### Products\n- `shopify_list_products` — List products with filters (status, vendor, type, title)\n- `shopify_get_product` — Get product by ID\n- `shopify_create_product` — Create a new product\n- `shopify_update_product` — Update title, description, status, tags, vendor\n- `shopify_count_products` — Get total product count\n\n### Orders\n- `shopify_list_orders` — List orders with filters (status, financial, fulfillment, date range)\n- `shopify_get_order` — Get order by ID\n- `shopify_update_order` — Update note, tags, email\n- `shopify_cancel_order` — Cancel an order\n- `shopify_count_orders` — Get total order count\n\n### Customers\n- `shopify_list_customers` — List customers\n- `shopify_get_customer` — Get customer by ID\n- `shopify_search_customers` — Search by name, email, phone\n- `shopify_count_customers` — Get total customer count\n\n### Collections\n- `shopify_list_collections` — List all custom + smart collections\n- `shopify_get_collection` — Get collection by ID\n- `shopify_list_collection_products` — List products in a collection\n\n### Metafields\n- `shopify_list_metafields` — List metafields for any resource\n- `shopify_set_metafield` — Create or update a metafield\n- `shopify_delete_metafield` — Delete a metafield by ID\n\n### Themes\n- `shopify_list_themes` — List all themes\n- `shopify_get_theme` — Get theme by ID\n- `shopify_list_theme_assets` — List all asset keys in a theme\n- `shopify_get_theme_asset` — Get file content of a theme asset\n- `shopify_update_theme_asset` — Write content to a theme file\n\n### GraphQL\n- `shopify_graphql` — Execute any GraphQL query or mutation\n\n## License\n\nMIT © [Apex Radius Labs](https://apexradiuslabs.com)\n","readmeFilename":"README.md"}