Rei-skills shopify-automation
Automate Shopify tasks via Rube MCP (Composio): products, orders, customers, inventory, collections. Always search tools first for current schemas.
git clone https://github.com/rootcastleco/rei-skills
T=$(mktemp -d) && git clone --depth=1 https://github.com/rootcastleco/rei-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/shopify-automation" ~/.claude/skills/rootcastleco-rei-skills-shopify-automation && rm -rf "$T"
skills/shopify-automation/SKILL.mdShopify Automation via Rube MCP
Automate Shopify operations through Composio's Shopify toolkit via Rube MCP.
Prerequisites
- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Shopify connection via
with toolkitRUBE_MANAGE_CONNECTIONSshopify - Always call
first to get current tool schemasRUBE_SEARCH_TOOLS
Setup
Get Rube MCP: Add
https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
- Verify Rube MCP is available by confirming
respondsRUBE_SEARCH_TOOLS - Call
with toolkitRUBE_MANAGE_CONNECTIONSshopify - If connection is not ACTIVE, follow the returned auth link to complete Shopify OAuth
- Confirm connection status shows ACTIVE before running any workflows
Core Workflows
1. Manage Products
When to use: User wants to list, search, create, or manage products
Tool sequence:
/SHOPIFY_GET_PRODUCTS
- List products [Optional]SHOPIFY_GET_PRODUCTS_PAGINATED
- Get single product details [Optional]SHOPIFY_GET_PRODUCT
- Create products in bulk [Optional]SHOPIFY_BULK_CREATE_PRODUCTS
- Get product count [Optional]SHOPIFY_GET_PRODUCTS_COUNT
Key parameters:
: Product ID for single retrievalproduct_id
: Product titletitle
: Product vendorvendor
: 'active', 'draft', or 'archived'status
Pitfalls:
- Paginated results require cursor-based pagination for large catalogs
- Product variants are nested within the product object
2. Manage Orders
When to use: User wants to list, search, or inspect orders
Tool sequence:
- List orders with filters [Required]SHOPIFY_GET_ORDERS_WITH_FILTERS
- Get single order details [Optional]SHOPIFY_GET_ORDER
- Get fulfillment details [Optional]SHOPIFY_GET_FULFILLMENT
- Track fulfillment events [Optional]SHOPIFY_GET_FULFILLMENT_EVENTS
Key parameters:
: Order status filter ('any', 'open', 'closed', 'cancelled')status
: Payment status filterfinancial_status
: Fulfillment status filterfulfillment_status
: Order ID for single retrievalorder_id
/created_at_min
: Date range filterscreated_at_max
Pitfalls:
- Order IDs are numeric; use string format for API calls
- Default order listing may not include all statuses; specify 'any' for all
3. Manage Customers
When to use: User wants to list or search customers
Tool sequence:
- List all customers [Required]SHOPIFY_GET_ALL_CUSTOMERS
Key parameters:
: Number of customers per pagelimit
: Pagination cursorsince_id
Pitfalls:
- Customer data includes order count and total spent
- Large customer lists require pagination
4. Manage Collections
When to use: User wants to manage product collections
Tool sequence:
- List smart collections [Optional]SHOPIFY_GET_SMART_COLLECTIONS
- Get collection details [Optional]SHOPIFY_GET_SMART_COLLECTION_BY_ID
- Create a smart collection [Optional]SHOPIFY_CREATE_SMART_COLLECTIONS
- Add product to collection [Optional]SHOPIFY_ADD_PRODUCT_TO_COLLECTION
- List products in collection [Optional]SHOPIFY_GET_PRODUCTS_IN_COLLECTION
Key parameters:
: Collection IDcollection_id
: Product ID for adding to collectionproduct_id
: Smart collection rules for automatic inclusionrules
Pitfalls:
- Smart collections auto-populate based on rules; manual collections use custom collections API
- Collection count endpoints provide approximate counts
5. Manage Inventory
When to use: User wants to check or manage inventory levels
Tool sequence:
/SHOPIFY_GET_INVENTORY_LEVELS
- Check stock [Required]SHOPIFY_RETRIEVES_A_LIST_OF_INVENTORY_LEVELS
- List store locations [Optional]SHOPIFY_LIST_LOCATION
Key parameters:
: Inventory item IDs to checkinventory_item_ids
: Location IDs to filter bylocation_ids
Pitfalls:
- Inventory is tracked per variant per location
- Location IDs are required for multi-location stores
Common Patterns
Pagination
- Use
andlimit
cursor for paginated resultspage_info - Check response for
link headernext - Continue until no more pages available
GraphQL Queries
For advanced operations:
1. Call SHOPIFY_GRAPH_QL_QUERY with custom query 2. Parse response from data object
Known Pitfalls
API Versioning:
- Shopify REST API has versioned endpoints
- Some features require specific API versions
Rate Limits:
- REST API: 2 requests/second for standard plans
- GraphQL: 1000 cost points per second
Quick Reference
| Task | Tool Slug | Key Params |
|---|---|---|
| List products | SHOPIFY_GET_PRODUCTS | (filters) |
| Get product | SHOPIFY_GET_PRODUCT | product_id |
| Products paginated | SHOPIFY_GET_PRODUCTS_PAGINATED | limit, page_info |
| Bulk create | SHOPIFY_BULK_CREATE_PRODUCTS | products |
| Product count | SHOPIFY_GET_PRODUCTS_COUNT | (none) |
| List orders | SHOPIFY_GET_ORDERS_WITH_FILTERS | status, financial_status |
| Get order | SHOPIFY_GET_ORDER | order_id |
| List customers | SHOPIFY_GET_ALL_CUSTOMERS | limit |
| Shop details | SHOPIFY_GET_SHOP_DETAILS | (none) |
| Validate access | SHOPIFY_VALIDATE_ACCESS | (none) |
| Smart collections | SHOPIFY_GET_SMART_COLLECTIONS | (none) |
| Products in collection | SHOPIFY_GET_PRODUCTS_IN_COLLECTION | collection_id |
| Inventory levels | SHOPIFY_GET_INVENTORY_LEVELS | inventory_item_ids |
| Locations | SHOPIFY_LIST_LOCATION | (none) |
| Fulfillment | SHOPIFY_GET_FULFILLMENT | order_id, fulfillment_id |
| GraphQL | SHOPIFY_GRAPH_QL_QUERY | query |
| Bulk query | SHOPIFY_BULK_QUERY_OPERATION | query |
When to Use
This skill is applicable to execute the workflow or actions described in the overview.
🏰 Rei Skills — Curated by Rootcastle Engineering & Innovation | Batuhan Ayrıbaş
Engineering Beyond Boundaries | admin@rootcastle.com