Setup

1. Add the Composio MCP server to your client configuration:

`` https://rube.app/mcp ``

1. Connect your Lemon Squeezy account when prompted (API key authentication).
2. Start issuing natural language commands to manage your store.

Core Workflows

1. Discover Stores and Products

List all stores to get store IDs, then retrieve products and variants for a specific store.

Tools: LEMONSQUEEZYLISTALLSTORES, LEMONSQUEEZYLISTALLPRODUCTS, LEMONSQUEEZYLISTALLVARIANTS

Example prompt:

"List all my Lemon Squeezy stores and their products"

Key parameters:

• LEMONSQUEEZYLISTALLSTORES -- No parameters required
• LEMONSQUEEZYLISTALLPRODUCTS -- Filter by filter[store_id]
• LEMONSQUEEZYLISTALLVARIANTS -- Filter by filter[product_id], filter[status] (pending/draft/published)

2. Track Orders and Order Items

Retrieve all orders with optional filtering by store, user email, or order number, and drill into individual order items.

Tools: LEMONSQUEEZYLISTALLORDERS, LEMONSQUEEZYLISTALLORDER_ITEMS

Example prompt:

"Show all orders from [email protected] in my Lemon Squeezy store"

Key parameters for orders:

• filter[store_id] -- Filter by store ID
• filter[user_email] -- Filter by customer email
• filter[order_number] -- Filter by specific order number
• page[number] / page[size] -- Pagination (max 100 per page)

Key parameters for order items:

• filter[orderid], filter[productid], filter[variant_id] -- Filter by related entity

3. Monitor Subscriptions

List all subscriptions with rich filtering options to track recurring revenue.

Tool: LEMONSQUEEZYLISTALLSUBSCRIPTIONS

Example prompt:

"Show all active subscriptions in my Lemon Squeezy store"

Key parameters:

• filter[status] -- Filter by status (e.g., active, cancelled)
• filter[store_id] -- Filter by store
• filter[product_id] -- Filter by product
• filter[user_email] -- Filter by subscriber email
• filter[variant_id] -- Filter by variant
• page[number] / page[size] -- Pagination (max 100 per page)

4. Manage Customers

Retrieve customer records with details including email, MRR, total revenue, and customer portal URLs.

Tool: LEMONSQUEEZYLISTALLCUSTOMERS

Example prompt:

"Find the Lemon Squeezy customer with email [email protected]"

Key parameters:

• filter[email] -- Filter by exact email address
• filter[store_id] -- Filter by store ID
• page[number] / page[size] -- Pagination (max 100 per page)

5. Audit Discounts and Redemptions

List all discount codes and track how they have been redeemed across orders.

Tools: LEMONSQUEEZYLISTALLDISCOUNTS, LEMONSQUEEZYLISTALLDISCOUNT_REDEMPTIONS

Example prompt:

"Show all discounts for store 12345 and their redemption history"

Key parameters for discounts:

• filter[store_id] -- Filter by store
• page[number] / page[size] -- Pagination

Key parameters for redemptions:

• filter[discount_id] -- Filter by discount
• filter[order_id] -- Filter by order

6. Review Checkouts

List all checkout sessions with optional filtering by store or variant.

Tool: LEMONSQUEEZYLISTALLCHECKOUTS

Example prompt:

"Show all checkouts for variant 42 in my Lemon Squeezy store"

Key parameters:

• filter[store_id] -- Filter by store ID
• filter[variant_id] -- Filter by variant ID

Known Pitfalls

• Store ID is foundational: Most filters require a storeid. Always call LEMONSQUEEZYLISTALL_STORES first to discover valid store IDs before filtering other resources.
• Pagination is mandatory for large datasets: All list endpoints use page[number] / page[size] pagination (max 100 per page). Do not assume the first page is complete.
• Filter parameter naming: Lemon Squeezy uses bracket notation for filters (e.g., filter[store_id], page[number]). Ensure exact parameter names are used.
• Subscription invoices vs. orders: Subscription invoices (LEMONSQUEEZYLISTALLSUBSCRIPTION_INVOICES) are separate from one-time orders. Use the appropriate endpoint for your use case.

Quick Reference

| List order items | LEMONSQUEEZYLISTALLORDER_ITEMS | None