From shopify-commerce
Manages Shopify customers via GraphQL Admin API mutations/queries for create/update/delete/tags/metafields, Customer Account API, Multipass SSO, segmentation, B2B accounts.
npx claudepluginhub orcaqubits/agentic-commerce-skills-plugins --plugin shopify-commerceThis skill is limited to using the following tools:
**Fetch live docs**:
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.
Guides MCP server integration in Claude Code plugins via .mcp.json or plugin.json configs for stdio, SSE, HTTP types, enabling external services as tools.
Fetch live docs:
site:shopify.dev customer account api for Customer Account APIsite:shopify.dev customer graphql admin api for customer mutationssite:shopify.dev multipass for SSO integrationsite:shopify.dev customer segmentation api for segmentation queriessite:shopify.dev b2b company accounts for B2B featuresModern, Shopify-hosted accounts:
Legacy accounts:
customers/login.liquid, customers/account.liquid)For headless/custom account experiences (used in Hydrogen):
Fetch live docs: Web-search
site:shopify.dev customer account api referencefor current OAuth flow endpoints, available queries, and token handling.
| Operation | Mutation | Notes |
|---|---|---|
| Create customer | customerCreate | Email, name, addresses |
| Update customer | customerUpdate | Partial updates |
| Delete customer | customerDelete | Removes customer record |
| Add tags | tagsAdd | Tagging for segmentation |
| Set metafield | metafieldsSet | Custom customer data |
| Send invite | customerSendAccountInviteEmail | Account activation email |
| Merge customers | customerMerge | Combine duplicate records |
Fetch live docs for each mutation's input fields —
CustomerInputand related types change across API versions.
# Pattern: query customer with orders and metafields
# Fetch live docs for current available fields
query Customer($id: ID!) {
customer(id: $id) {
id
firstName
lastName
email
phone
tags
addresses { address1 city province country zip }
orders(first: 10) {
edges {
node { id name totalPrice { amount currencyCode } }
}
}
metafields(first: 5) {
edges {
node { namespace key value type }
}
}
}
}
# Search customers by email, name, or other fields
query Customers($query: String!) {
customers(first: 10, query: $query) {
edges { node { id email firstName lastName } }
}
}
# query: "email:customer@example.com" or "first_name:John"
Fetch live docs for query filter syntax and searchable fields.
Single sign-on for Shopify stores (Shopify Plus only):
{store}.myshopify.com/account/login/multipass/{token}Your site → Encrypt customer JSON with Multipass secret → Base64 token
→ Redirect to Shopify /account/login/multipass/{token}
→ Customer auto-logged in
Required customer data in the token: email (required), plus optional first_name, last_name, tag_string, return_to, remote_ip.
Fetch live docs: Web-search
site:shopify.dev multipassfor current encryption algorithm, token format, and required fields. The encryption method (AES-128-CBC + HMAC-SHA256) is stable but verify key derivation steps.
Filter customers based on criteria:
orders_count > 5 AND total_spent > 100Fetch live docs: Web-search
site:shopify.dev customer segmentation filtersfor current filter syntax and available attributes.
Shopify Plus feature:
Company
├── Locations (billing/shipping)
├── Contacts (linked to customers)
├── Catalogs (company-specific pricing)
│ └── Price Lists
└── Payment Terms
Fetch live docs: Web-search
site:shopify.dev b2b api companyfor company mutations, catalog assignment, and payment terms configuration.
GDPR/privacy compliance:
SUBSCRIBED, NOT_SUBSCRIBED, PENDING, UNSUBSCRIBEDcustomerEmailMarketingConsentUpdate and customerSmsMarketingConsentUpdateFetch live docs for consent mutation input fields and consent state transition rules.
customers/data_request, customers/redact)customerMerge for duplicate records instead of manual data transferFetch the Shopify Customer Account API, Multipass, and B2B documentation for exact OAuth flows, encryption details, mutation inputs, and segmentation syntax before implementing.