Lemon Squeezy
Lemon Squeezy is a platform designed to simplify payments, taxes, and subscriptions for software companies, offering a powerful API and webhooks for seamless integration.
Verdict
Common use cases
- Verify customer purchase before granting support
- Pull last month's revenue by product variant
- Check which affiliates drove the most sales
- Create checkout links for custom deals
- Audit discount code redemptions before renewal
Integration
- Vendor
- Lemon Squeezy
- Category
- other
- Auth
- API_KEY
- Tools
- 18
- Composio slug
lemon_squeezy
Tools
- Create Customer
Tool to create a new customer. use after verifying the store exists and you need to add a customer to it. example: "create a customer john doe with email johndoe@example.com in store 1."
- List All Affiliates
Tool to list all affiliates. use when you need to retrieve affiliates with optional filters and pagination.
- List All Checkouts
Tool to list all checkouts. use when you need a paginated list of checkouts, optionally filtering by store or variant.
- List All Customers
Tool to list all customers. use when you need a paginated list of customers with optional filters.
- List All Discount Redemptions
Tool to list all discount redemptions. use when you need a paginated list of discount redemptions, optionally filtering by discount or order.
- List All Discounts
Tool to list all discounts. use when you need a paginated list of discounts after confirming authentication.
- List All License Key Instances
Tool to list all license key instances. use when you need a paginated list of license key instances, optionally filtering by license key id.
- List All Order Items
Tool to list all order items. use when you need a paginated list of order items, optionally filtered by order, product, or variant.
- List All Orders
Tool to list all orders. use when you need a paginated list of orders, optionally filtering by store or user email.
- List All Prices
Tool to list all prices. use when you need a paginated list of all prices, optionally filtering by variant.
- List All Products
Tool to list all products. use when you need to fetch your full product catalog.
- List All Stores
Tool to list all stores. use when you need to retrieve every store belonging to the authenticated account.
- List All Subscription Invoices
Tool to list all subscription invoices. use when you need a paginated list of subscription invoices with optional filters.
- List All Subscription Items
Tool to list all subscription items. use when you need a paginated list of items across subscriptions for reporting or auditing.
- List All Subscriptions
Tool to list all subscriptions. use when you need a paginated list of subscriptions, optionally filtered by store, order, product, or status.
- List All Usage Records
Tool to list all usage records. use when you need a paginated list of usage records, optionally filtered by subscription item id.
- List All Variants
Tool to list all variants. use after selecting a product to retrieve its variants, optionally filtered by status.
- List All Webhooks
Tool to list all webhooks. use when you need to retrieve registered webhooks, optionally filtered by store. use after confirming your store id.
Setup
Setup guide
- 11. In Switchy, open Settings and navigate to Integrations. 2. Find Lemon Squeezy in the MCP directory and click Connect. 3. Log into your Lemon Squeezy dashboard, go to Settings > API, and generate a new API key with the scopes you need (at minimum: read customers, read orders, read subscriptions; add write scopes if you want to create customers or checkouts). 4. Copy the key and paste it into the Switchy connection modal, then click Authorize. 5. Open any Space and type '@Lemon Squeezy list all customers' — if you see a table of customer records, the connection works. 6. To invoke other tools, @mention Lemon Squeezy and describe what you need in plain language (e.g. 'show me orders from the last week' or 'create a customer for jane@example.com').
What teammates see: by default, memories from Lemon Squeezy are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Recent High-Value Orders
@Lemon Squeezy list all orders from the past 30 days and filter for those over $500. Show customer email and order total.Open in a Space →
Customer Purchase History
@Lemon Squeezy find all orders for customer email user@example.com and list product names, order dates, and statuses.Open in a Space →
Active Subscription Count
@Lemon Squeezy list all active subscriptions and group them by product variant. Show the count for each.Open in a Space →
Discount Performance Report
@Lemon Squeezy list all discount redemptions from the last quarter and calculate total discount amount per code.Open in a Space →
Create Customer Record
@Lemon Squeezy create a customer named Alex Smith with email alex@example.com in store ID 12345.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@lemon-squeezy show me all customers who signed up in the last 30 days, grouped by their subscription plan
Based on the customer list from your Lemon Squeezy store, here's what I found for the last 30 days: **Pro Plan (12 customers)** Most recent: sarah.chen@example.com (Jan 15), mike.torres@example.com (Jan 14) **Starter Plan (8 customers)** Most recent: alex.kim@example.com (Jan 16), jordan.lee@example.com (Jan 13) **Enterprise Plan (3 customers)** All three signed up between Jan 10-12. This example illustrates the kind of customer segmentation you'd see. Actual results depend on your store's customer base and subscription structure.
This example combines the List All Customers tool with AI reasoning to segment by plan and recency. Requires read access to customer data via your Lemon Squeezy API key. The MCP returns raw customer records; the AI handles grouping and summarization. Large customer bases may hit pagination limits—results show the first page by default.
@lemon-squeezy create a new customer named Emma Rodriguez with email emma.r@designstudio.co for store ID 4521
Customer created successfully in store 4521: **Emma Rodriguez** Email: emma.r@designstudio.co Customer ID: cust_a8f3k2m9 Status: Active Created: January 17, 2025 This customer can now be associated with orders, subscriptions, or license keys in your Lemon Squeezy dashboard. No payment method has been attached yet—that happens during checkout or can be added manually.
This demonstrates the Create Customer tool, which adds a customer record to your store before any purchase. Useful for pre-provisioning accounts or migrating existing users. Requires your store ID (find it in Lemon Squeezy settings) and write permissions on your API key. Creating a customer does NOT trigger billing—it's just a contact record until paired with an order.
@lemon-squeezy pull all discount redemptions from the last week and tell me which discount code drove the most revenue
Analyzing discount redemptions from Jan 10-17: **LAUNCH50 (50% off)**: 47 redemptions, ~$8,340 in discounted revenue **FRIEND20 (20% off)**: 31 redemptions, ~$4,960 in discounted revenue **EARLYBIRD (30% off)**: 18 redemptions, ~$2,520 in discounted revenue LAUNCH50 had the highest redemption count and total revenue impact, though it also gave the steepest discount. This is an illustrative summary—actual figures come from your order data paired with discount metadata.
This example chains List All Discount Redemptions with order item data to calculate revenue impact. The MCP provides redemption records and discount details; the AI does the math and ranking. Requires read access to both discounts and orders. If you have hundreds of redemptions, pagination may truncate results—consider narrowing the date range or filtering by specific discount IDs.
Use-case deep-dives
When this MCP works for monthly affiliate reporting
A 6-person SaaS team runs an affiliate program with 40 partners and needs to reconcile payouts every month. The Lemon Squeezy MCP pulls affiliate data, discount redemptions, and order items into one Switchy thread so the finance lead can cross-check commission rates against actual orders without logging into the dashboard. This works cleanly if you're under 200 affiliates and your payout logic is straightforward percentage splits. Above that threshold or if you have tiered commission structures that require custom calculations, you'll spend more time writing prompts than exporting a CSV and using a spreadsheet. If your affiliate count is stable and your team does this monthly, the MCP saves 20 minutes per cycle and keeps the audit trail in Switchy.
When this MCP speeds up license key lookups
A 3-person support team for a developer tool gets 15-20 tickets per week about license activation failures. The Lemon Squeezy MCP lets the support agent pull license key instances and customer records directly in the Switchy thread where they're drafting the reply, so they can verify the key status and seat count without switching tabs. This is the right call if your product uses node-locked or floating licenses and your support volume is under 50 tickets per week. If you're handling 100+ tickets daily or your licensing logic involves custom entitlements outside Lemon Squeezy's model, the MCP becomes a bottleneck because it can't write back or trigger resets. For small teams with straightforward licensing, this cuts 3-5 minutes per ticket and keeps the context in one place.
When this MCP fits post-campaign reporting
A 5-person marketing team runs quarterly discount campaigns with 8-12 promo codes and needs to report which codes drove the most revenue and which customers redeemed them. The Lemon Squeezy MCP pulls discount redemptions, order items, and customer lists into a Switchy thread so the team can draft the board deck without waiting on engineering to write a custom report. This works if your campaign has fewer than 20 discount codes and you're okay with manual aggregation in the thread. If you need real-time dashboards or you're running 50+ concurrent codes across multiple stores, the pagination and lack of bulk export make this slower than a direct API script. For quarterly retrospectives where the team wants to discuss the data while looking at it, the MCP keeps the analysis and the narrative in the same workspace.
Frequently asked
What does the Lemon Squeezy MCP do in Switchy?
It lets your AI agents read and manage your Lemon Squeezy store data — customers, orders, subscriptions, discounts, affiliates, and license keys. You can create customers, list checkouts, pull order items, or check discount redemptions without leaving the chat. Useful for support teams answering billing questions or ops teams auditing subscription data.
Do I need admin access to connect Lemon Squeezy?
You need an API key from your Lemon Squeezy account settings. Any team member with access to the account's API keys page can generate one. The key has full read-write access to your store data, so treat it like a password and only share it with people who should manage billing.
Can the MCP process refunds or cancel subscriptions?
The current tool set focuses on reading data and creating customers. It doesn't expose refund or subscription-cancellation endpoints yet. For those actions, you'll still need to log into Lemon Squeezy directly or use their REST API outside Switchy.
How is this different from just using Lemon Squeezy's dashboard?
The MCP brings your store data into the same workspace where your team already chats with AI. Instead of switching tabs to look up a customer's order history or check which discount code was used, you ask the agent and it pulls the answer in seconds. Faster for one-off queries; the dashboard is still better for bulk edits.
Who on the team should connect this integration?
Whoever owns your Lemon Squeezy account or has permission to generate API keys. Once connected in Switchy, any team member in the workspace can query the data through the AI agent — they don't need their own Lemon Squeezy login. Just make sure your workspace access matches who should see billing details.