---
title: Shopify AI Toolkit
description: >-
  The AI Toolkit connects your AI tools to Shopify's dev platform and store
  management capabilities via plugin, skills, or MCP server.
source_url:
  html: 'https://shopify.dev/docs/apps/build/ai-toolkit'
  md: 'https://shopify.dev/docs/apps/build/ai-toolkit.md'
---

# 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:](#install-with-a-plugin)** The plugin updates automatically, so you'll always have the latest capabilities as they're released.
* **[Install with agent skills:](#install-with-agent-skills)** Manually add some or all of the AI Toolkit's agent skill files.
* **[Install with the Dev MCP server:](#install-with-the-dev-mcp-server)** Connect to Shopify's developer resources through an MCP server.

***

## Requirements

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

***

## Install 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.

#### Claude Code

1. In Claude Code, enable the Shopify marketplace:

   ## Claude Code chat

   ```terminal
   /plugin marketplace add Shopify/shopify-ai-toolkit
   ```

2. Then, install the plugin:

   ## Claude Code chat

   ```terminal
   /plugin install shopify-plugin@shopify-plugin
   ```

#### Cursor

To install, [add the Shopify plugin](https://cursor.com/marketplace/shopify) in the Cursor Marketplace.

#### Gemini CLI

In your terminal, run `gemini extensions install`:

## Terminal

```terminal
gemini extensions install https://github.com/Shopify/shopify-ai-toolkit
```

#### VS Code

1. Ensure the [Agent plugins](https://code.visualstudio.com/docs/copilot/customization/agent-plugins) preview is enabled in your VS Code settings.

2. Open the Command Palette (`Cmd+Shift+P` on MacOS, `Ctrl+Shift+P` on Windows/Linux) and run:

   Chat: Install Plugin From Source

3. Enter the repository URL:

   https://github.com/Shopify/shopify-ai-toolkit

***

## Install 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](https://github.com/Shopify/Shopify-AI-Toolkit/tree/main/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

```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

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

***

## Install 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

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

   ## Terminal

   ```terminal
   claude mcp add --transport stdio shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest
   ```

2. Restart Claude Code to load the new configuration.

#### Codex CLI

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

   ## Codex configuration

   ```toml
   [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](https://github.com/openai/codex/blob/main/docs/config.md#mcp_servers).

2. Restart Codex to load the new configuration.

#### Cursor

1. Open Cursor and go to **Cursor** > **Settings** > **Cursor Settings** > **Tools and MCP** > **New MCP server**.

2. Add this configuration to your MCP servers (or [use this link](https://cursor.com/en/install-mcp?name=shopify-dev-mcp\&config=eyJjb21tYW5kIjoibnB4IC15IEBzaG9waWZ5L2Rldi1tY3BAbGF0ZXN0In0%3D) to add it automatically):

   ## Cursor configuration

   ```json
   {
     "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

   ```json
   {
     "mcpServers": {
       "shopify-dev-mcp": {
         "command": "cmd",
         "args": ["/k", "npx", "-y", "@shopify/dev-mcp@latest"]
       }
     }
   }
   ```

3. Save your configuration and restart Cursor.

#### Gemini CLI

1. Add this configuration to your `settings.json` file:

   ## Gemini CLI configuration

   ```json
   {
     "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](https://google-gemini.github.io/gemini-cli/docs/tools/mcp-server.html).

2. Restart Gemini CLI to load the new configuration.

#### VS Code

1. Open VS Code and open the Command Palette (`Cmd+Shift+P` on MacOS, `Ctrl+Shift+P` on Windows/Linux).

2. Search for and select **MCP: Open User Configuration**.

3. Add this configuration to your user-level `mcp.json` file:

   ## VS Code MCP configuration

   ```json
   {
     "servers": {
       "shopify-dev-mcp": {
         "command": "npx",
         "args": ["-y", "@shopify/dev-mcp@latest"]
       }
     }
   }
   ```

4. Save your configuration and restart VS Code.

***

## Related resources

[Shopify CLI\
\
](https://shopify.dev/docs/apps/build/cli-for-apps)

[Command-line tool for building Shopify apps and themes.](https://shopify.dev/docs/apps/build/cli-for-apps)

[Scaffold an app\
\
](https://shopify.dev/docs/apps/build/scaffold-app)

[Get started building with Shopify by scaffolding your app.](https://shopify.dev/docs/apps/build/scaffold-app)

***