Skip to main content

Shopify AI Toolkit

AI coding agents can search the web, read documentation, and inspect your codebase, but they still need the right context at the right time to be effective. Shopify development depends on platform-specific details: which API surface applies, what fields exist in a schema, which CLI command to run, and how an app or extension configuration should be validated.

Shopify AI Toolkit gives your AI coding tool a Shopify-aware starting point. The toolkit connects your agent to:

  • Developer docs and API schemas: look up the relevant Shopify API surface and work from current reference material, rather than relying only on model memory or broad web search.
  • Code validation: validate GraphQL queries, Liquid templates, and Shopify Extensions against Shopify schemas to catch issues earlier.
  • Store management: prepare and run supported store-management tasks through Shopify CLI's authenticated store context, with you choosing when to execute them.

Before you install the Shopify AI Toolkit, make sure you have:

  • Node.js 18 or higher installed on your system.
  • A supported AI tool: Claude Code, Codex, Antigravity CLI, Cursor, Hermes (plugin only), or Visual Studio Code.

Plugins are the recommended way to install the AI Toolkit. The plugin bundles everything into a single install and updates automatically as new capabilities are released.

In your terminal, run claude plugin install:

Terminal

claude plugin install shopify-ai-toolkit@claude-plugins-official

Anchor to Install with agent skillsInstall with agent skills

If you prefer to pick specific capabilities, you can manually add individual agent skills. You can browse the full list of available skills on GitHub. Note that manually added skills don't auto-update, so you'll need to pull updates yourself.

To install all skills:

Terminal

npx skills add Shopify/shopify-ai-toolkit

To install a single skill, use the --skill flag. For example, to install only the GraphQL Admin API skill:

Terminal

npx skills add Shopify/shopify-ai-toolkit --skill shopify-admin

Anchor to Install with the Dev MCP serverInstall with the Dev MCP server

If you prefer MCP, you can connect to Shopify's developer resources through the Dev MCP server. The server runs locally and doesn't require authentication.

  1. In your terminal, tell claude to add the MCP server:

    Terminal

    claude mcp add --transport stdio shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest
  2. Restart Claude Code to load the new configuration.


Anchor to Example: migrate extensions with the toolkitExample: migrate extensions with the toolkit

One clear use case is extension migration. Checkout and customer account Shopify Extensions on API versions before 2025-10 need to adopt Polaris web components when upgrading to newer API versions.

These migrations involve repetitive, detail-heavy work:

  • Updating the extension API version in shopify.extension.toml.
  • Converting React-based extension code to Preact where required.
  • Replacing legacy components with Polaris web components.
  • Updating extension APIs and target-specific imports.
  • Reviewing the migration guide to confirm all required steps.
  • Running and testing the migrated extension locally.

With the toolkit installed, you can ask your agent to handle the migration. For example:

Example prompt

Migrate the extensions/my-checkout-extension extension to API version 2026-04.

The toolkit doesn't remove the need to review and test the result. It helps automate the bulk of the migration work so you can spend more time validating behavior and preparing the updated extension for release.


After installing, your AI tool automatically draws on Shopify's developer resources when you ask it Shopify-related questions. Ask it to:

  • Use Shopify CLI to scaffold a new Shopify app.
  • Explain what Shopify app surfaces are and help you choose the right one.
  • Explore Shopify APIs and find the right one for your use case.
  • Review your app against Shopify App Store requirements.

Was this page helpful?