Shopify Automation via Rube MCP

Automate Shopify operations through Composio's Shopify toolkit via Rube MCP.

Toolkit docs: composio.dev/toolkits/shopify

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 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:

• 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 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:

• 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:

• 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 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:

• 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 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

Powered by Composio