ranbot-ai/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

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

   https://rube.app/mcp
   

2. Connect your Lemon Squeezy account when prompted (API key authentication).
3. 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 [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[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 [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: 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

| Action | Tool Slug | Required Params | |---|---|---| | List stores | LEMON_SQUEEZY_LIST_ALL_STORES | None | | List products | LEMON_SQUEEZY_LIST_ALL_PRODUCTS | None (optional filters) | | List variants | LEMON_SQUEEZY_LIST_ALL_VARIANTS | None (optional filters) | | List orders | LEMON_SQUEEZY_LIST_ALL_ORDERS | None (optional filters) | | List order items | LEMON_SQUEEZY_LIST_ALL_ORDER_ITEMS | None