Install
claude plugin install shopify-ai-toolkit@claude-plugins-officialWho it's for
If you are developing a Shopify app or working on a store and want an agent to use official documentation, API schemas, and code validation directly, this toolkit is a good fit. Shopify officially says it gives agents Shopify documentation, API schemas, and code validation for building apps, and that its CLI's store execute capability can be used for store management.
For your first attempt, use only the Claude plugin installation below; do not list installation commands for other products alongside it in the article. The page also names Cursor and Codex. That only means those environments are mentioned; it does not mean you should switch installers for your first attempt.
It is a better fit for people who can already run the claude plugin command and want to start by looking up documentation or validating code, rather than executing store operations immediately. See the official documentation at
https://github.com/shopify/shopify-ai-toolkit
Complete your first attempt in 3 minutes
Use only this official installation path:
claude plugin install shopify-ai-toolkit@claude-plugins-official
Prerequisite: a Claude plugin environment is already available on your machine. Once installed, start with a read-only lookup: ask the agent to explain an interface you are using based on Shopify documentation or an API schema, and do not run store execute first. Each time a skill script is called, it sends a usage event to
https://shopify.dev/mcp/usage
The payload includes the tool or skill name and may include the user prompt. Telemetry is enabled by default. The page says that exiting disables reporting from the skill scripts, MCP service, and hooks at the same time, and also stops storing prompts locally, but it does not give the exit command itself; before your first call, either accept this default behavior or find the official exit method yourself.
A successful result means the plugin is installed and the agent can answer by citing documentation or a schema instead of saying it is not installed. A validation request should identify whether the code conforms to the given schema, and you should know that this call may have been counted as a usage event.
Use cases
Case 1: start by looking up documentation and API schemas.
Shopify lists documentation and API schemas as capabilities provided by the toolkit. For your first question, ask about one specific interface or field and compare the answer with what you see in Shopify's documentation. The page does not specify a search syntax for the documentation site; what can be confirmed is that the agent will use this documentation and these schemas.
Case 2: validate app code before changing the repository.
The same statement also covers code validation for building apps. On your first try, ask the agent only to validate an existing snippet and do not modify files. The page names these skill scripts: scripts/search_docs.mjs, scripts/validate.mjs, scripts/log_skill_use.mjs, but it does not say that you should run these files yourself. Validation triggers the usage event described above. Review the validation feedback before allowing code changes.
Store management uses the CLI's store execute capability and changes data on the store side, so it is not suitable as a first attempt. The page does not provide a parameter table for execute.
Usage boundaries
The only primary installation path in the article is claude plugin install shopify-ai-toolkit@claude-plugins-official. Do not switch to another installation command for your first attempt.
Telemetry is enabled by default. Every call to a skill script sends a usage event to
https://shopify.dev/mcp/usage
Exiting applies to the skill scripts, MCP service, and hooks together, and stops prompts from being captured locally. The page does not state the specific command for turning this off in these passages.
store execute is for store management and carries more risk than looking up documentation or validating code. No store permission scope or dry-run mode is specified. Do not treat the toolkit as a replacement for Shopify's official documentation.