How to Set Up Shopify AI Toolkit with Claude Code

On April 9, 2026, Shopify open-sourced a toolkit that connects Claude Code directly to the Shopify platform — not to training data about Shopify, but to the actual live developer docs, GraphQL schemas, and CLI. The difference matters: ask Claude for a product mutation query without the toolkit and you get a best guess from eight months ago. With the toolkit, you get the current validated syntax.

The toolkit gives Claude Code three things: real-time access to Shopify developer documentation, local GraphQL schema validation that checks every query before it runs, and the ability to execute live store operations through the Shopify CLI. That third layer — actual execution — is what separates this from an autocomplete upgrade. Claude can create products, manage metafields, modify theme files, and run bulk operations without you writing a single query by hand.

There are three ways to wire it up: a plugin (the recommended path, auto-updates), an MCP server (single terminal command, direct integration), and manual agent skills (granular control for teams that want to enable capabilities one at a time). This guide covers all three, plus the authentication step that most tutorials skip, and a section on what you can actually do with Claude Code once it's running on your store.

TL;DR

What the Shopify AI Toolkit Actually Does

The toolkit is not a single tool — it's a bundle of skill files and a Dev MCP server that connect Claude to three distinct layers of the Shopify platform.

Documentation access. Claude searches current Shopify developer docs in real time. Ask it about the correct API syntax for a specific operation and it returns what Shopify actually documents today, not a cached approximation from its training cutoff.

Schema validation. The toolkit bundles Shopify's GraphQL API schemas locally. Every query Claude generates is checked against the real schema before it runs — which eliminates the class of bugs where a query passes in the playground but fails in production because a field was renamed or deprecated.

Store execution. Through the Shopify CLI, Claude can run live operations: create and update products, manage metafields, modify theme files, and run bulk operations. This executes immediately with no draft queue and no undo. According to Shopify's official AI Toolkit documentation, rollback is not supported in the current release — test every operation on a development store first.

How to Set Up Shopify AI Toolkit with Claude Code

Steps 1 and 3–4 apply regardless of which install method you choose. Step 2a, 2b, and 2c are the three installation paths — pick one.

Step 1: Verify Prerequisites

You need Node.js 18 or higher before anything else. Check your current version:

If the output is below v18.0.0, update from nodejs.org before continuing. Claude Code must already be installed.

Step 2a: Install via Plugin (Recommended)

The plugin bundles everything into one install and auto-updates whenever Shopify ships new capabilities. Open a Claude Code chat session and run these two commands in order:

This is the lowest-friction path for most developers — no config files to edit, no manual update steps.

Step 2b: Install via MCP Server

One terminal command connects Claude Code to all tools in the Shopify Dev MCP server:

Restart Claude Code after running this. On Windows, connection errors are common with the default config. Use cmd as the entry point instead — add it manually to your Claude MCP settings file:

To opt out of telemetry (the server sends instrumentation data by default), add an env block:

Step 2c: Install via Manual Agent Skills

Manual skills let you enable capabilities one at a time. To install all available skills:

To install a single skill — for example, only the GraphQL Admin API skill:

Browse the full skills list on GitHub to see what's available. Note: manually installed skills don't auto-update, so you'll need to pull new versions yourself.

Step 3: Authenticate for Store Operations

Documentation search and schema validation work immediately after install. Store operations require one additional step.

Run the Shopify CLI login command:

This opens a browser window to authorize Claude Code against your Shopify Partner account. As of January 1, 2026, new Shopify apps use OAuth client credentials rather than static access tokens — the CLI handles this exchange automatically. Tokens are valid for approximately 24 hours and refresh before expiry.

Make sure your Partner account has the appropriate permissions for the operations you plan to run before testing anything on a production store.

Step 4: Verify the Connection

Ask Claude something that requires current documentation to answer accurately:

"What's the correct GraphQL mutation to update a product's title in the Shopify Admin API?"

If the toolkit is active, Claude returns a validated query with current field names. If it hedges with phrases like "this may have changed since my training" or generates deprecated fields, the MCP connection isn't loading — restart Claude Code and check your config.

Which Shopify AI Toolkit Setup Method Should You Use?

For most use cases, the plugin is the right call. The MCP server is worth choosing if you're already managing MCP configuration as code or want to control telemetry from day one. Manual skills make sense when any new tool capability requires a formal review before deployment.

What Claude Code Can Do for Your Shopify Store

Once the toolkit is connected, Claude Code can handle a range of tasks that would otherwise take hours of manual API work. Here's what this looks like in practice.

Bulk Product Description Generation

Describe your product category, target audience, and the SEO keywords you're targeting. Claude generates optimized copy for each product using the current Admin API product mutation, then applies changes in bulk — across hundreds of SKUs in a single session. You review the outputs before anything goes live.

This is particularly useful when launching a new product category or rewriting descriptions after a brand refresh. Claude maintains consistent tone across the catalog without you manually editing each record.

Prompt: Read all products in my store whose titles contain "xxx (e.g., Ceramic)". Generate an SEO-optimized product description of around 150 words for each item with a warm tone suitable for North American families, then update the descriptions directly to the store.

Inventory Alerts and Adjustments

Claude can query inventory levels across all locations using the inventoryLevels connection, flag SKUs below a set threshold, and draft the inventoryAdjustQuantities mutations needed to correct them. You define the rules — Claude runs the checks and prepares the adjustments for your review.

For Shopify stores with multiple warehouses or fulfillment partners, this turns a daily manual audit into a 30-second query.

Prompt: Query all products with inventory lower than 10 units, add "[Low Stock]" to the front of their titles, and meanwhile list all products whose cost per item is higher than the selling price for me.

Theme Code Debugging

Describe the layout issue or visual bug. Claude reads the current theme files, identifies the Liquid code causing the problem, checks the fix against the theme schema, and applies it. The schema validation step catches mismatched section settings before they break the live store.

Start with the dev store — describe the bug, let Claude identify it, review the proposed fix, then apply it. Claude can also explain why the original code had the problem, which is useful for preventing the same issue from recurring.

Prompt: Check the checkout.liquid file of my current theme, locate the code related to the custom field "gift_message", and find out why it fails to render in the latest version.

Bulk SEO Optimization

Claude can generate SEO titles and meta descriptions for entire collections, update them via metafield mutations, and confirm the writes completed — all in one session. Give it your target keyword list and brand voice guidelines, and it handles the copy and the API calls together.

This is more reliable than spreadsheet-based bulk editors because Claude validates each mutation against the current schema before running it. Deprecated fields fail cleanly rather than silently.

Prompt: Find all products that do not have a meta description. Generate a meta description within 160 characters based on the product title and description, include primary keywords to drive clicks, then update them in batches.

Competitor Price Monitoring and Response

Claude can generate the GraphQL query logic and Shopify Flow trigger configurations to monitor your own prices relative to targets, and draft bulk productVariantsBulkUpdate mutations to adjust pricing in response. For actual competitor data, you'd connect a third-party price intelligence tool — Claude handles the Shopify side of the response: which products to update, by how much, and in what sequence.

For stores with large catalogs and dynamic pricing rules, this replaces hours of manual repricing with a describable workflow.

Prompt: Check the prices of the "Vintage Lamp" products of Competitor A and Competitor B at 10 a.m. every day. If their prices are more than 10% lower than mine, automatically generate a limited-time discount code in the format: PRICE + date, set the discount margin 5% lower than competitors', and send me an email notification.

Safe Theme Modifications

Before making any theme change, Claude checks which sections are customizable via the theme schema vs. hardcoded in Liquid. It tells you which edits are reversible through the Shopify theme editor and which require code changes — so you understand the rollback options before touching anything.

This matters because theme changes from the CLI don't go through the same version history as the theme editor. Claude flags that distinction and suggests which approach is safer for each modification.

Customer Service Automation

Claude Code can draft canned response templates, build Shopify Flow automations for order status notifications, and set up webhook handlers for common customer query types — all through the Admin API and without leaving your terminal.

For live inbound calls and chat that happen outside business hours — the midnight order question, the Saturday refund request — Solvea connects directly to Shopify and handles those conversations without a human in the loop. It resolves order inquiries, processes return requests, and escalates to a human agent when the situation requires it. Anker reported a 70% reduction in manual customer service work after deployment. Claude Code handles the automation setup; Solvea handles the live customer conversations.

Data Reporting Automation

Claude can write custom GraphQL queries for order analytics, customer lifetime value, and inventory turnover — then format the output for direct export to Google Sheets or as structured JSON for your reporting pipeline. Describe the metric you need and the time range, and Claude generates the query, runs it, and returns the data.

This is more flexible than Shopify's built-in reports because you can combine data from multiple resources in a single query. Claude can also schedule recurring queries using Shopify Flow triggers, so you get updated numbers on a cadence rather than running the same query manually each week.

Prompt: Generate a store data report for last week (Monday to Sunday), including:

Total sales, number of orders, average order value (compared with the growth rate of the week before last)

Top 10 best-selling products

Top 5 traffic sources

Return rate and refund amount

Conversion funnel (Visit → Add to Cart → Checkout → Payment)

Format requirements:

Display core data in a table

List 3-5 key insights

Provide 2-3 suggested actions for next week

Conclusion

The Shopify AI Toolkit changes what Claude Code can do with a Shopify store — from generating plausible code to executing validated API calls against your actual store. Setup takes under ten minutes regardless of method, with the plugin being the lowest-friction path and the MCP server giving you the most configuration control.

The step that most guides skip: authentication. Documentation search and schema validation work immediately after install, but store operations need shopify auth login before anything executes. Get that done first, run your initial tests on a development store, and work up to production operations once you understand how the execution model behaves — there's no undo.

FAQ

Does the Shopify AI Toolkit work with Claude Code on Windows?

Yes, but the MCP server configuration requires cmd as the command entry point. Use "command": "cmd" with "args": ["/k", "npx", "-y", "@shopify/dev-mcp@latest"] in your MCP settings file. The plugin install method (/plugin marketplace add and /plugin install) works identically across all operating systems.

Do I need a paid Shopify plan to use the AI Toolkit?

The toolkit itself is free and open source. It connects to Shopify's API, which requires a Partner account or an active store. Store operations use your existing API access — no additional plan tier is required.

Is the Shopify AI Toolkit the same as the Dev MCP server?

Not exactly. The Dev MCP server (@shopify/dev-mcp) is one component of the broader AI Toolkit. The full toolkit also includes agent skill files and supports plugin installation. The MCP server is the direct integration path that bypasses the plugin layer.

Can Claude Code make changes to a live production store?

Yes — and that's the primary risk. Store execute operations run immediately with no draft queue or rollback support. Test every new operation type on a development store before running it in production. The Shopify CLI's store execute capability has no confirmation step between the command and the API call.

What's the difference between the plugin and the MCP install?

The plugin bundles all skill files and the MCP connection into one install that auto-updates. The MCP install gives you direct access to the Dev MCP server's tools without the plugin layer — useful if you want to manage the connection in config-as-code or need to customize the server environment. Both methods give Claude Code access to current Shopify documentation and schema validation.