Shopify 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
RUBE_MANAGE_CONNECTIONS with toolkit shopify
- Always call
RUBE_SEARCH_TOOLS first to get current tool schemas
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
RUBE_SEARCH_TOOLS responds
- Call
RUBE_MANAGE_CONNECTIONS with toolkit shopify
- 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 / SHOPIFY_GET_PRODUCTS_PAGINATED - List products [Optional]SHOPIFY_GET_PRODUCT - Get single product details [Optional]SHOPIFY_BULK_CREATE_PRODUCTS - Create products in bulk [Optional]SHOPIFY_GET_PRODUCTS_COUNT - Get product count [Optional]
Key parameters:
product_id: Product ID for single retrievaltitle: Product titlevendor: Product vendorstatus: 'active', 'draft', or 'archived'
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:
SHOPIFY_GET_ORDERS_WITH_FILTERS - List orders with filters [Required]SHOPIFY_GET_ORDER - Get single order details [Optional]SHOPIFY_GET_FULFILLMENT - Get fulfillment details [Optional]SHOPIFY_GET_FULFILLMENT_EVENTS - Track fulfillment events [Optional]
Key parameters:
status: Order status filter ('any', 'open', 'closed', 'cancelled')financial_status: Payment status filterfulfillment_status: Fulfillment status filterorder_id: Order ID for single retrievalcreated_at_min/created_at_max: Date range filters
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:
SHOPIFY_GET_ALL_CUSTOMERS - List all customers [Required]
Key parameters:
limit: Number of customers per pagesince_id: Pagination cursor
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:
SHOPIFY_GET_SMART_COLLECTIONS - List smart collections [Optional]SHOPIFY_GET_SMART_COLLECTION_BY_ID - Get collection details [Optional]SHOPIFY_CREATE_SMART_COLLECTIONS - Create a smart collection [Optional]SHOPIFY_ADD_PRODUCT_TO_COLLECTION - Add product to collection [Optional]SHOPIFY_GET_PRODUCTS_IN_COLLECTION - List products in collection [Optional]
Key parameters:
collection_id: Collection IDproduct_id: Product ID for adding to collectionrules: Smart collection rules for automatic inclusion
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 / SHOPIFY_RETRIEVES_A_LIST_OF_INVENTORY_LEVELS - Check stock [Required]SHOPIFY_LIST_LOCATION - List store locations [Optional]
Key parameters:
inventory_item_ids: Inventory item IDs to checklocation_ids: Location IDs to filter by
Pitfalls:
- Inventory is tracked per variant per location
- Location IDs are required for multi-location stores
Common Patterns
Pagination
- Use
limit and page_info cursor for paginated results
- Check response for
next link header
- 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.
