Query and manage Shopify stores via GraphQL Admin API. Use when working with products, orders, customers, inventory, discounts, marketing, translations, fulfillments, or any Shopify store data.
A comprehensive skill for interacting with Shopify's GraphQL Admin API. This skill enables Claude to query and manage all aspects of Shopify store data including products, orders, customers, inventory, marketing, discounts, translations, fulfillments, and more.
SHOPIFY_STORE_URL - Your store URL (e.g., my-store.myshopify.com)SHOPIFY_ACCESS_TOKEN - Admin API access tokenquery {
products(first: 10) {
nodes {
id
title
status
}
}
}
mutation CreateProduct($product: ProductCreateInput!) {
productCreate(product: $product) {
product {
id
title
}
userErrors {
field
message
}
}
}
Variables:
{
"product": {
"title": "New Product",
"status": "DRAFT"
}
}
When working with Shopify GraphQL:
shopify_graphql tool to execute queries and mutationserrors array indicates GraphQL/syntax issuesuserErrors in mutations indicate validation/business logic issuesfirst/after cursorsgid://shopify/Resource/123IMPORTANT: Before executing any of the following operations, you MUST ask for explicit user permission. These operations are irreversible or have significant business impact.
When Claude encounters any critical operation:
Example:
WARNING: This will permanently deactivate gift card gid://shopify/GiftCard/123
with a balance of $50.00. This action cannot be undone.
Do you want to proceed? (yes/no)
This skill provides comprehensive patterns for all major Shopify domains:
| Domain | Operations | File |
|---|---|---|
| Products | List, get, search, create, update, delete products and variants | products.md |
| Orders | List, get details, fulfill, cancel orders | orders.md |
| Customers | List, get, create, update customers | customers.md |
| Inventory | Check levels, adjust quantities, manage locations | inventory.md |
| Collections | List collections, manage products in collections | collections.md |
| Domain | Operations | File |
|---|---|---|
| Discounts | Code/automatic discounts, BXGY, free shipping | discounts.md |
| Marketing | Marketing activities, events, consent | marketing.md |
| Segments | Customer segments for targeting | segments.md |
| Domain | Operations | File |
|---|---|---|
| Translations | Translate products, pages, content | translations.md |
| Markets | Multi-market setup, localized content | markets.md |
| Domain | Operations | File |
|---|---|---|
| Pages | Create/update store pages | pages.md |
| Blogs | Blogs and articles | blogs.md |
| Menus | Navigation menus | menus.md |
| Files | File uploads, media library | files.md |
| Metafields | Custom data, metaobjects | metafields.md |
| Domain | Operations | File |
|---|---|---|
| Fulfillments | Create fulfillments, tracking | fulfillments.md |
| Shipping | Delivery profiles, zones, rates | shipping.md |
| Locations | Manage inventory locations | locations.md |
| Domain | Operations | File |
|---|---|---|
| Draft Orders | Create orders on behalf of customers | draft-orders.md |
| Refunds | Process refunds, restocking | refunds.md |
| Gift Cards | Create, credit, debit gift cards | gift-cards.md |
| Subscriptions | Subscription contracts, billing | subscriptions.md |
| Domain | Operations | File |
|---|---|---|
| Shop | Store info, settings, ShopifyQL | shop.md |
| Webhooks | Event subscriptions | webhooks.md |
| Bulk Operations | Large async queries/mutations | bulk-operations.md |
All Shopify GraphQL IDs are globally unique: