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

shopify-automation

NPX Install

SKILL.md Content

Shopify Automation via Rube MCP

Prerequisites

Setup

Core Workflows

1. Manage Products

2. Manage Orders

3. Manage Customers

4. Manage Collections

5. Manage Inventory

Common Patterns

Pagination

GraphQL Queries

Known Pitfalls

Quick Reference