Shopify AI Toolkit

The Shopify AI Toolkit connects your AI tools to the Shopify platform. With the Toolkit, you can build apps using Shopify's documentation, API schemas, and code validation, and manage your Shopify store through the CLI's store execute capabilities. The Toolkit ensures your agent works with Shopify correctly, rather than guessing at how things are implemented.

You can set up the AI Toolkit via our plugin, or manually with skills or MCP:

(Recommended) Install the plugin: The plugin updates automatically, so you'll always have the latest capabilities as they're released.
Install with agent skills: Manually add some or all of the AI Toolkit's agent skill files.
Install with the Dev MCP server: Connect to Shopify's developer resources through an MCP server.

Anchor to RequirementsRequirements

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 (skills and MCP only), Cursor, Gemini CLI, or Visual Studio Code

Anchor to Install with a pluginInstall with a plugin

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 Claude Code, enable the Shopify marketplace:

Claude Code chat
/plugin marketplace add Shopify/shopify-ai-toolkit
Then, install the plugin:

Claude Code chat
/plugin install shopify-plugin@shopify-plugin

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.

Claude Code

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
Restart Claude Code to load the new configuration.

Codex CLI

Add this configuration to your ~/.codex/config.toml file:

Codex configuration
[mcp_servers.shopify-dev-mcp]
command = "npx"
args = ["-y", "@shopify/dev-mcp@latest"]

Note
Codex uses TOML format with mcp_servers (snake_case) instead of JSON with mcpServers (camelCase). For more information, see the Codex MCP documentation.
Restart Codex to load the new configuration.

Cursor

Open Cursor and go to Cursor > Settings > Cursor Settings > Tools and MCP > New MCP server.
Add this configuration to your MCP servers (or use this link to add it automatically):

Cursor configuration
{
"mcpServers": {
"shopify-dev-mcp": {
"command": "npx",
"args": ["-y", "@shopify/dev-mcp@latest"]
}
}
}

If you see connection errors on Windows, try this alternative configuration:

Alternative configuration for Windows
{
"mcpServers": {
"shopify-dev-mcp": {
"command": "cmd",
"args": ["/k", "npx", "-y", "@shopify/dev-mcp@latest"]
}
}
}
Save your configuration and restart Cursor.

Gemini CLI

Add this configuration to your settings.json file:

Gemini CLI configuration
{
"mcpServers": {
"shopify-dev-mcp": {
"command": "npx",
"args": ["-y", "@shopify/dev-mcp@latest"]
}
}
}

Note
To make the server available across all projects, add the --scope user flag. For more information, see the Gemini CLI MCP documentation.
Restart Gemini CLI to load the new configuration.

VS Code

Open VS Code and open the Command Palette (Cmd+Shift+P on MacOS, Ctrl+Shift+P on Windows/Linux).
Search for and select MCP: Open User Configuration.
Add this configuration to your user-level mcp.json file:

VS Code MCP configuration
{
"servers": {
"shopify-dev-mcp": {
"command": "npx",
"args": ["-y", "@shopify/dev-mcp@latest"]
}
}
}
Save your configuration and restart VS Code.

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
Restart Claude Code to load the new configuration.

Anchor to Related resourcesRelated resources

Shopify CLI

Command-line tool for building Shopify apps and themes.

Scaffold an app

Get started building with Shopify by scaffolding your app.

Was this page helpful?