Lemon Squeezy Automation

Lemon Squeezy Automation

Manage your Lemon Squeezy digital products business -- track orders, monitor subscriptions, analyze customers, review discounts, and audit checkouts -- all through natural language commands.

Toolkit docs: composio.dev/toolkits/lemon_squeezy

---

Setup

Add the Composio MCP server to your client configuration:

https://rube.app/mcp

Connect your Lemon Squeezy account when prompted (API key authentication).

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: LEMON_SQUEEZY_LIST_ALL_STORES, LEMON_SQUEEZY_LIST_ALL_PRODUCTS, LEMON_SQUEEZY_LIST_ALL_VARIANTS

Example prompt:
> "List all my Lemon Squeezy stores and their products"

Key parameters:

LEMON_SQUEEZY_LIST_ALL_STORES -- No parameters required

LEMON_SQUEEZY_LIST_ALL_PRODUCTS -- Filter by filter[store_id]

LEMON_SQUEEZY_LIST_ALL_VARIANTS -- 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: LEMON_SQUEEZY_LIST_ALL_ORDERS, LEMON_SQUEEZY_LIST_ALL_ORDER_ITEMS

Example prompt:
> "Show all orders from johndoe@example.com 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[order_id], filter[product_id], filter[variant_id] -- Filter by related entity

---

3. Monitor Subscriptions

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

Tool: LEMON_SQUEEZY_LIST_ALL_SUBSCRIPTIONS

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

Example prompt:
> "Find the Lemon Squeezy customer with email johndoe@example.com"

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: LEMON_SQUEEZY_LIST_ALL_DISCOUNTS, LEMON_SQUEEZY_LIST_ALL_DISCOUNT_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: LEMON_SQUEEZY_LIST_ALL_CHECKOUTS

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 store_id. Always call LEMON_SQUEEZY_LIST_ALL_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 (LEMON_SQUEEZY_LIST_ALL_SUBSCRIPTION_INVOICES) are separate from one-time orders. Use the appropriate endpoint for your use case.

---

Quick Reference

---

Powered by Composio