PluginInstalls cleanly
Build for your Shopify store
Shopify AI Toolkit
Shopify's official toolkit gives your assistant current Shopify docs, checks theme and app code against Shopify's rules and helps manage your store.
- Works with
- Claude Code, Codex CLI
- Good for
- Web developers, Build an app
What it does
Shopify is a platform for running an online shop. Changing a shop's theme or building a small Shopify app means following many Shopify-specific rules, and AI assistants often guess them from old knowledge.
This toolkit comes from Shopify. It lets your assistant search Shopify's current developer docs and API schemas, and it checks code before you use it: GraphQL queries, Liquid theme templates and app extensions are validated against Shopify's own rules.
It has two skills. The shopify skill covers every Shopify developer topic, with one guide per topic. The ucp skill needs a separate UCP CLI.
It can also run store-management tasks through the Shopify CLI with your signed-in store. Shopify's docs say you choose when those run.
Telemetry is on by default. The skill scripts and two hooks send usage events to Shopify; see the risks for what is sent and how to turn it off.
Example prompts
- "Add a size guide to my product page theme and validate the Liquid."
- "Write a GraphQL query that lists my products with low stock, and check it against the schema."
- "Explain what this Shopify error means and fix it."
- "Which Shopify API should I use to add a discount from my app?"
How to install
claude plugin install shopify-ai-toolkit@claude-plugins-officialHow to use it
Ask: Change my Shopify theme so the product page shows a size guide, and validate the Liquid before you finish. The skills load by themselves for Shopify tasks.
Other assistants
Codex (from the README):
codex plugin add shopify@openai-curatedStart a new session afterwards. The opt-out file is the safe way to stop telemetry in Codex, because Codex's exec mode does not pass your environment variables on (README). We have not tested the Codex route.
Check it works
In Claude Code, run /plugin and check that shopify-ai-toolkit is listed as installed. Type / and look for the skill, probably /shopify-ai-toolkit:shopify (our reading, not tested).
Common problems
- Skill scripts fail to run — Node.js is older than 18 (our reading) — install Node.js 18 or higher, as Shopify's requirements say — https://shopify.dev/docs/apps/build/ai-toolkit
- Telemetry still sends after setting OPT_OUT_INSTRUMENTATION — some hosts, including Codex exec mode, do not pass your environment on — use the opt-out file instead (README) — https://github.com/Shopify/Shopify-AI-Toolkit
- The plugin does not load in Claude Code — follow the plugin troubleshooting steps in the Claude Code docs — https://code.claude.com/docs/en/discover-plugins
What to watch out for
- Telemetry is on by default and sends usage events to shopify.dev, including search text, validated code and, on Claude Code, your latest prompt when a Shopify skill runs; opt out with the file ~/.config/shopify-ai-toolkit/opt-out, which the README calls the only method that works everywhere (OPT_OUT_INSTRUMENTATION=true and DO_NOT_TRACK=1 also work when your environment is passed on) (README)
- Adds hooks: one runs after every prompt you send and saves the prompt on your computer, and one runs after Skill and Read calls to report Shopify skill use (hooks/hooks.json, README); the opt-out file stops both
- The main skill is set to load for any Shopify task, and even for prompts like 'make me a store that sells pet supplies' that do not say Shopify (skill description), so telemetry can start without you naming Shopify
- Store management runs Shopify CLI commands with your signed-in store, so changes can affect a live shop; Shopify's docs say you choose when to run them
- Needs Node.js 18 or higher (Shopify docs)
- The README says the plugin updates itself automatically; through Anthropic's directory you get the version it pins (2.1.2 on 2026-10-23) until that pin moves (our reading)
Licence and author
- Licence
- MIT
- Author
- Shopify
- Source code
- github.com/Shopify/Shopify-AI-Toolkit
How we tested it
We installed it on an empty test computer on 23 Oct 2026. Installed and started in a clean test system. Not yet used in a real AI session.
Not run: "codex plugin add shopify@openai-curated" (not a form the sandbox runs). Not yet used on real work. The official marketplace installs commit 3c32168 (2026-10-14, version 2.1.2); no store sign-in, so no store command ran.
Technical details of the test
- Date
- 23 Oct 2026
- Method
- Intake sandbox run on 2026-10-23 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files; installed shopify-ai-toolkit@claude-plugins-official with the Claude Code command line.
Checked again on 23 Oct 2026
Alternatives
- Wix Skills — for shops and sites built on Wix
- Build with WordPress — for WordPress and WooCommerce sites
- Stripe AI Toolkit — payments without a Shopify store
FAQ
- Q: Does it cost money? A: The toolkit is free (MIT). Shopify's docs page does not give a price or plan for it.
- Q: Do I need a Shopify store? A: For store-management tasks, yes, you sign in to your store. Docs search and code checks do not seem to need one (our reading).
- Q: Can it change my live shop? A: Store-management commands can. Try changes on a development store or theme copy first.
- Q: Does it work in Gemini CLI? A: Shopify's docs do not list Gemini CLI.
- Q: How do I stop telemetry? A: Create the opt-out file shown in the risks; it covers every part of the toolkit: skill scripts, the MCP server and the hooks (README).
Sources
- github.com/Shopify/Shopify-AI-Toolkit
- github.com/Shopify/Shopify-AI-Toolkit/blob/main/hooks/hooks.json
- shopify.dev/docs/apps/build/ai-toolkit