pcruvinel/shopify-automation

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.

1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
2. Call RUBE_MANAGE_CONNECTIONS with toolkit shopify
3. If connection is not ACTIVE, follow the returned auth link to complete Shopify OAuth
4. 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:

1. SHOPIFY_GET_PRODUCTS / SHOPIFY_GET_PRODUCTS_PAGINATED - List products [Optional]
2. SHOPIFY_GET_PRODUCT - Get single product details [Optional]
3. SHOPIFY_BULK_CREATE_PRODUCTS - Create products in bulk [Optional]
4. SHOPIFY_GET_PRODUCTS_COUNT - Get product count [Optional]

Key parameters:

• product_id: Product ID for single retrieval
• title: Product title
• vendor: Product vendor
• status: '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:

1. SHOPIFY_GET_ORDERS_WITH_FILTERS - List orders with filters [Required]
2. SHOPIFY_GET_ORDER - Get single order details [Optional]
3. SHOPIFY_GET_FULFILLMENT - Get fulfillment details [Optional]
4. SHOPIFY_GET_FULFILLMENT_EVENTS - Track fulfillment events [Optional]

Key parameters:

• status: Order status filter ('any', 'open', 'closed', 'cancelled')
• financial_status: Payment status filter
• fulfillment_status: Fulfillment status filter
• order_id: Order ID for single retrieval
• created_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:

1. SHOPIFY_GET_ALL_CUSTOMERS - List all customers [Required]

Key parameters:

• limit: Number of customers per page
• since_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:

1. SHOPIFY_GET_SMART_COLLECTIONS - List smart collections [Optional]
2. SHOPIFY_GET_SMART_COLLECTION_BY_ID - Get collection details [Optional]
3. SHOPIFY_CREATE_SMART_COLLECTIONS - Create a smart collection [Optional]
4. SHOPIFY_ADD_PRODUCT_TO_COLLECTION - Add product to collection [Optional]
5. SHOPIFY_GET_PRODUCTS_IN_COLLECTION - List products in collection [Optional]

Key parameters:

• collection_id: Collection ID
• product_id: Product ID for adding to collection
• rules: 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:

1. SHOPIFY_GET_INVENTORY_LEVELS / SHOPIFY_RETRIEVES_A_LIST_OF_INVENTORY_LEVELS - Check stock [Required]
2. SHOPIFY_LIST_LOCATION - List store locations [Optional]

Key parameters:

• inventory_item_ids: Inventory item IDs to check
• location_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 |