Menu
Mattering Automations connector

A Lemon Squeezy MCP where the whole surface, refunds included, rehearses in test mode

Connect one API key and Lemon Squeezy orders, subscriptions, refunds, usage-based billing, license keys, checkouts, and webhooks become workflow steps for visual automations and AI agents. There is no separate sandbox host to learn: a test mode key sees only test data on the same URL, so even the two refund nodes and the full subscription lifecycle can be rehearsed end to end with documented test cards and zero real money.

38 ready-made nodes One credential to connect Works with Claude, ChatGPT, and Matter

What the Lemon Squeezy MCP connector does

The Lemon Squeezy connector for Mattering Automations is 38 nodes across the Lemon Squeezy API: stores, catalog reads (products, variants, and the price objects behind them), customers with an archive path, orders with API refunds, the full subscription lifecycle (plan changes, pause, resume, and cancel with a resumable grace period), subscription invoices with refunds and PDF generation, usage-based billing, discount codes, license keys plus the activate, validate, and deactivate License API, checkout link creation, and webhook management. Lemon Squeezy is a merchant of record and a Stripe company, and its API is actively maintained, with changelog entries into July 2026 and no announced sunset.

Every node speaks MCP, the open protocol for connecting AI assistants to tools, so Claude, ChatGPT, and any MCP-capable assistant can use them, alongside Matter, the AI assistant built into the platform. An assistant can answer which subscriptions are past due, what a customer has spent over their lifetime, and whether an order has been refunded, without anyone opening the Lemon Squeezy dashboard.

Because Mattering is a work platform rather than middleware, billing work lands somewhere useful by default: a scheduled sweep over past due and freshly cancelled subscriptions can open tasks in Mattering Productivity while there is still time to save the customer, and license key activations can log to a Mattering database, all on one canvas next to the rest of the work.

The money boundary is explicit, and so is the way to rehearse it. Seven nodes are flagged destructive: Lemon Squeezy: Refund Order and Lemon Squeezy: Refund Subscription Invoice move real money (an empty amount means a full refund, an amount in cents means a partial one, and no refund can be reversed), Lemon Squeezy: Update Subscription and Lemon Squeezy: Update Subscription Item Quantity change real billing and charge the customer immediately when invoice_immediately is set, Lemon Squeezy: Create Usage Record writes what a customer will be invoiced for and has no delete, Lemon Squeezy: Delete Discount is permanent, and Lemon Squeezy: Cancel Subscription ends recurring revenue, though with a grace period that keeps it resumable until the paid period ends. The safety valve is test mode: keys are created in live or test mode, a test mode key sees only test data on the same URL, and documented test cards mean the entire destructive set can be rehearsed with zero real money.

One connection, three surfaces

  • Visual automations. Drag Lemon Squeezy nodes onto the canvas and wire them to triggers, conditions, and other apps.
  • AI agents, yours or ours. These nodes speak MCP, the open protocol, so Claude, ChatGPT, and any MCP-capable assistant can use them, and Matter, the agent built into the platform, uses them natively.
  • The whole platform. Combine with native tasks, projects, and other connectors, no middleware in between.

Every Lemon Squeezy node, ready to drop on the canvas

38 nodes, generated from the connector itself so this list always matches what ships. Expand a category to browse.

Read and query nodes 19

Lemon Squeezy: Get Authenticated User

Retrieve the user the API key belongs to. Needs no parameters, so this is also the credential health check, and data.meta.test_mode tells you whether the key is a live mode or test mode key.

Lemon Squeezy: Get Checkout

Retrieve a checkout by its UUID (checkout IDs are UUIDs, not integers), including its live URL, price and prefill configuration, and expiry.

Lemon Squeezy: Get Customer

Retrieve one customer by ID, including lifetime revenue, MRR, marketing status, and the signed customer portal URL.

Lemon Squeezy: Get License Key

Retrieve one license key by its numeric ID (also returned in License API responses as license_key.id): full key string, status, activation limit and usage, expiry.

Lemon Squeezy: Get Order

Retrieve one order by ID, including totals, tax, refund state (refunded, refunded_amount), first_order_item, and the signed receipt URL.

Lemon Squeezy: Get Subscription

Retrieve one subscription by ID: status, pause state, cancelled flag, billing anchor, renews_at / ends_at, first_subscription_item (whose id feeds the quantity and usage nodes), and signed customer portal URLs.

Lemon Squeezy: Get Subscription Item Current Usage

Retrieve the reported usage total for a usage-based subscription item in the current billing period, with the period start and end. Returns 404 if the item is not usage-based. Pairs with Create Usage Record to verify what will be billed.

Lemon Squeezy: List Customers

List customers with revenue and MRR figures, filtered by store or exact email. The email filter is the standard look-up-a-customer step in automation flows.

Lemon Squeezy: List Discounts

List discount codes with amount, type, duration, limits, and status, optionally filtered to one store. List responses return full discount objects, so no separate get is needed.

Lemon Squeezy: List License Keys

List license keys generated by orders, filtered by store, order, order item, product, or status (inactive, active, expired, disabled). Includes the full key string, activation limits, and instance counts.

Lemon Squeezy: List Orders

List orders, newest first, filtered by store, customer email, or order number. Totals are integer cents with formatted twins; each order carries first_order_item and a signed receipt URL.

Lemon Squeezy: List Prices

List price objects (the billing truth behind variants: unit price in cents, pricing scheme, usage aggregation, tiers, setup fees, renewal and trial intervals), optionally filtered to one variant. Price IDs appear on subscription items.

Lemon Squeezy: List Products

List products, ordered by name, optionally filtered to one store. Each product carries price display fields and its hosted buy_now_url. List responses return full product objects, so no separate get is needed.

Lemon Squeezy: List Stores

List all stores this API key can see, with revenue and sales stats per store. Store IDs from here feed the create nodes (customer, discount, checkout, webhook).

Lemon Squeezy: List Subscription Invoices

List subscription invoices (the billing history of subscriptions), newest first, filtered by store, status (pending, paid, void, refunded, partially_refunded), refunded flag, or subscription. Invoice IDs feed the refund and generate-invoice nodes; list responses return full invoice objects.

Lemon Squeezy: List Subscriptions

List subscriptions, newest first, filtered by store, order, product, variant, customer email, or status (on_trial, active, paused, past_due, unpaid, cancelled, expired). Each carries renews_at, ends_at, pause state, and signed customer portal URLs.

Lemon Squeezy: List Usage Records

List reported usage records, newest first, optionally filtered to one subscription item. The audit trail for usage-based billing.

Lemon Squeezy: List Variants

List variants (the purchasable versions of a product, including subscription billing interval and license key settings), optionally filtered by product or status. Variant IDs from here feed Create Checkout and the subscription plan-change node.

Lemon Squeezy: List Webhooks

List webhook endpoints with their subscribed events and last_sent_at, optionally filtered to one store. The signing secret is never returned by the API (dashboard only).

Action nodes 19

Lemon Squeezy: Activate License Key

Activate a license key, creating a named instance and consuming one activation slot (activation_usage goes up; at the limit, activation fails with activated false and an error message). Reversible: Deactivate License Key frees the slot. Uses the License API: form-encoded, plain JSON response (not JSON:API), no Bearer auth needed because the license key itself is the credential. 60 requests per minute.

Lemon Squeezy: Cancel Subscription

ENDS REAL RECURRING REVENUE: cancel a subscription. The honest semantics: the subscription flips to cancelled and enters a grace period until its ends_at date (the end of the paid period), during which it CAN still be resumed via Lemon Squeezy: Update Subscription with cancelled false. After ends_at it expires permanently and the customer must re-subscribe. There is no immediate-termination option on this endpoint.

Lemon Squeezy: Create Checkout

Create a unique checkout URL for a variant, returned at data.data.attributes.url. NOTE WHAT THIS MAKES: with a live mode key the URL is a REAL checkout that accepts real payments from anyone holding the link, including at a custom price. Prefill customer details and custom data, override product name and price (custom_price in cents, also used for renewals on subscriptions), style the page, and set expires_at so programmatic links do not live forever. Creating the checkout itself charges nothing.

Lemon Squeezy: Create Customer

Create a customer record in a store (name and email; optional location). Reversible: a customer can be archived later via Lemon Squeezy: Update Customer with status archived.

Lemon Squeezy: Create Discount

Create a discount code redeemable at checkout: percent or fixed amount, optional redemption cap, validity window, and subscription duration (once, repeating, forever). Reversible in the sense that Delete Discount removes it, though a delete is itself permanent.

Lemon Squeezy: Create Usage Record

AFFECTS REAL BILLING: report usage against a usage-based subscription item; the reported quantity is what the customer is invoiced for at the end of the billing period. action increment adds to the period's running total (for sum aggregation), action set replaces it (for most-recent aggregation). There is no delete for usage records, so a wrong increment can only be corrected by compensating reports. Verify totals with Get Subscription Item Current Usage.

Lemon Squeezy: Create Webhook

Register a webhook endpoint for store events (e.g. order_created, subscription_created, subscription_updated, subscription_expired, subscription_payment_success, license_key_created). Point it at a Mattering inbound webhook trigger to react to sales in automations. You supply the signing secret; the API never returns it, so keep your own copy. Reversible via Delete Webhook.

Lemon Squeezy: Deactivate License Key

Deactivate one activation instance of a license key, freeing its activation slot (reversible by activating again). Uses the License API: form-encoded, plain JSON response, no Bearer auth. 60 requests per minute.

Lemon Squeezy: Delete Discount

PERMANENTLY delete a discount code. There is no undo and no unpublish: the code stops working immediately and its redemption history is gone. The discount itself can be recreated from its attributes, but the history cannot. Returns 204 with an empty body on success.

Lemon Squeezy: Delete Webhook

Delete a webhook endpoint so it stops receiving events. Classed reversible because a webhook is recreatable losslessly (URL, events, and secret are all client-supplied), but the deletion itself has no undo. Returns 204 with an empty body on success.

Lemon Squeezy: Generate Subscription Invoice PDF

Generate a customer-addressed invoice PDF for a subscription invoice and get back a signed download URL at data.meta.urls.download_invoice. The address fields go onto the invoice document; nothing about the invoice record itself changes, so this is safe to re-run.

Lemon Squeezy: Refund Order

MOVES REAL MONEY: refund an order, sending money back to the customer's payment method. Leave amount empty for a FULL refund; set amount in cents for a partial refund (100 refunds $1.00 on a USD order). A refund cannot be reversed once issued. Returns the order with updated refunded fields. On a test mode key this refunds test money only.

Lemon Squeezy: Refund Subscription Invoice

MOVES REAL MONEY: refund a subscription invoice payment, sending money back to the customer's payment method. Leave amount empty for a FULL refund; set amount in cents for a partial refund. A refund cannot be reversed once issued. Returns the invoice with updated refunded fields. On a test mode key this refunds test money only.

Lemon Squeezy: Update Customer

Update a customer's profile fields, or archive the customer by setting status to archived (stops marketing emails to them). archived is the only status value the API documents for writes, so treat archiving as one-way from the API side. Profile field edits are freely reversible.

Lemon Squeezy: Update License Key

Change a license key's activation limit, expiry date, or disabled state. All three are reversible: re-enable with disabled false, extend or clear expiry, raise or lower the limit (null via extra_attrs means unlimited activations).

Lemon Squeezy: Update Subscription

CHANGES REAL BILLING: the subscription lifecycle control. Change plan (variant_id; prorated by default, and invoice_immediately true charges the customer NOW), pause payment collection (pause object; unpause by sending pause null via extra_attrs), resume a pending cancellation (cancelled false, before ends_at), move the billing date (billing_anchor day of month; changing it issues a prorated adjustment), or adjust the trial end. PayPal funded subscriptions cannot be modified by the API; the response instead carries a customer portal URL to send the customer to.

Lemon Squeezy: Update Subscription Item Quantity

CHANGES REAL BILLING: set the billed unit quantity on a quantity-based subscription (seats, units). Prorated by default at the next renewal; invoice_immediately true charges the prorated difference NOW. Only for quantity-based billing: a usage-based subscription item returns 422 (report usage with Create Usage Record instead). Get the subscription item ID from the subscription's first_subscription_item.id.

Lemon Squeezy: Update Webhook

Change a webhook's destination URL, subscribed events, or signing secret. Any field left empty is kept as-is.

Lemon Squeezy: Validate License Key

Check whether a license key (or one specific activation instance of it) is valid, without changing anything. Returns valid true or false with the license key details and related order, product, and customer IDs in meta. Uses the License API: form-encoded, plain JSON response, no Bearer auth. 60 requests per minute.

Connecting Lemon Squeezy takes one credential

Lemon Squeezy issues API keys from Settings > API in the dashboard. The key is sent as a bearer credential on every request, is created in either live mode or test mode (the mode decides which data it can see), and is valid for one year, after which it must be replaced. The three License API nodes are the one exception to bearer auth: on those calls the license key itself is the credential.

1

In the Lemon Squeezy dashboard, open Settings > API and create an API key. Keys are minted in live mode or test mode and are valid for one year; a test mode key is the safe way to start.

2

In Mattering Automations, open Connectors, click Add Connector, choose Lemon Squeezy, and create a credential with that key.

3

Click Test Connection. Mattering retrieves the authenticated user with the key, and the response also reports whether the key is a live mode or test mode key.

4

All 38 Lemon Squeezy nodes appear in the canvas palette. Run Lemon Squeezy: List Stores first: store ids from it feed the create nodes for customers, discounts, checkouts, and webhooks.

Common uses for the Lemon Squeezy MCP

Revenue and customer reads an agent can do

Lemon Squeezy: List Orders returns orders newest first with totals in integer cents and signed receipt URLs, Lemon Squeezy: List Customers carries lifetime revenue and MRR per customer with an exact email filter, and Lemon Squeezy: List Subscriptions filters by status (on_trial, active, paused, past_due, unpaid, cancelled, expired). All read-only, which makes them the safest surface to hand an assistant.

Checkout links minted on demand

Lemon Squeezy: Create Checkout builds a unique checkout URL for a variant, with prefilled customer details, custom data, an overridden price in cents, and page styling. On a live mode key that URL is a real checkout that accepts real payments from anyone holding the link, so set expires_at on programmatic links. Creating the checkout itself charges nothing.

The subscription lifecycle without the dashboard

Lemon Squeezy: Update Subscription changes plans (prorated by default; invoice_immediately bills the customer now), pauses and unpauses payment collection, and moves the billing anchor. Cancellation is kinder than most billing APIs: Lemon Squeezy: Cancel Subscription starts a grace period until the end of the paid period, and until then the subscription can be resumed with Lemon Squeezy: Update Subscription setting cancelled to false, so a save flow has a real window to work in.

Refunds that are gated, not guessed

Lemon Squeezy: Refund Order and Lemon Squeezy: Refund Subscription Invoice send money back to the customer's payment method. An empty amount issues a full refund, an amount in cents issues a partial one, and no refund can be reversed once issued, so gate both behind a condition, an approval step, or a manual run. On a test mode key they refund test money only.

License keys managed end to end

Lemon Squeezy: List License Keys and Lemon Squeezy: Update License Key handle activation limits, expiry, and the disabled flag, while Lemon Squeezy: Activate License Key, Lemon Squeezy: Validate License Key, and Lemon Squeezy: Deactivate License Key run the activation lifecycle itself. Those three use the License API, where the license key in the request is the credential, and activation slots are consumed on activate and freed on deactivate.

Usage-based billing reported and audited

Lemon Squeezy: Create Usage Record reports the quantity a customer is invoiced for at the end of the billing period, adding with increment or replacing with set. Usage records cannot be deleted, only corrected with compensating reports, so verify totals with Lemon Squeezy: Get Subscription Item Current Usage and keep Lemon Squeezy: List Usage Records as the audit trail.

Example: Failed payments and fresh cancellations become tasks while there is still time to save them

Built on the Automations canvas in a few minutes, or described in plain language to Matter and built for you.

1

Trigger: a daily schedule starts the sweep.

2

Lemon Squeezy: List Subscriptions filters to status past_due for failed renewal payments, then runs again filtered to status cancelled for subscriptions still inside their grace period.

3

Lemon Squeezy: Get Customer resolves each one to a name, email, lifetime revenue, and MRR, so the follow-up knows who it is talking to.

4

A task opens in Mattering Productivity for each at-risk subscription, with the customer, the amount, and the ends_at date attached, assigned to whoever owns billing follow-up.

5

A row lands in a Mattering database so churn risk trends over time instead of vanishing into a dashboard nobody checks.

6

Cancelled subscriptions stay resumable until their ends_at date, so a saved customer needs only Lemon Squeezy: Update Subscription with cancelled set to false, no new checkout required.

Lemon Squeezy MCP questions, answered

What Lemon Squeezy operations are supported?

38 nodes: stores, catalog reads (products, variants, and prices), customers with an archive path, orders with refunds, subscriptions with the full lifecycle, subscription invoices with refunds and PDF generation, usage-based billing (report and read usage), discount codes, license keys plus the License API activation trio, checkout creation and retrieval, and webhook management. Deliberately not shipped: get-by-id twins where list responses already return complete objects, the order-side invoice generator (orders carry a signed receipt URL on every read), standalone order item and subscription item reads (both are embedded in their parents), files, discount redemptions, affiliates, and a checkout list, since checkouts are mint-and-use URLs.

Does this work with Claude, ChatGPT, or other AI assistants?

Yes. Mattering exposes these nodes over MCP, an open protocol for connecting AI assistants to tools, so any MCP-capable assistant, including Claude and ChatGPT, can connect to your workspace and use them. Matter, the assistant built into the platform, uses the same nodes natively.

Can this connector move real money?

Yes, and it says so loudly. Seven nodes are flagged destructive. Lemon Squeezy: Refund Order and Lemon Squeezy: Refund Subscription Invoice send money back to the customer's payment method: an empty amount means a full refund, an amount in cents means a partial one (100 refunds $1.00 on a USD order), and no refund can be reversed once issued. Lemon Squeezy: Update Subscription and Lemon Squeezy: Update Subscription Item Quantity change real billing and charge immediately when invoice_immediately is set. Lemon Squeezy: Create Usage Record writes what a customer will be invoiced for and has no delete. Lemon Squeezy: Delete Discount kills a code permanently along with its redemption history. Lemon Squeezy: Cancel Subscription ends recurring revenue, though with a resumable grace period. Gate all of them behind conditions, approval steps, or manual runs, and rehearse them with a test mode key first.

How do I test without spending real money?

With a test mode key, and there is no separate sandbox host to configure. Lemon Squeezy keys are created in live mode or test mode, and a test mode key sees and creates only test data against the same API URL. Checkout testing uses documented test cards such as 4242 4242 4242 4242, so a test checkout mints a test order, subscription, and license key, and the entire surface, both refund nodes included, runs end to end with zero real money. Lemon Squeezy: Get Authenticated User reports whether the connected key is a live mode or test mode key, so a workflow can check before anything destructive runs.

What happens when a subscription is cancelled?

Something friendlier than most billing APIs. Lemon Squeezy: Cancel Subscription flips the subscription to cancelled and starts a grace period that lasts until the end of the already-paid period. During that window the subscription can be resumed with Lemon Squeezy: Update Subscription setting cancelled to false, with nothing lost. After the period ends it expires permanently and the customer must subscribe again. There is no immediate-termination option on the endpoint, which makes an accidental cancellation recoverable in a way an accidental refund is not.

Can a Lemon Squeezy event trigger a workflow?

There is no dedicated trigger node in this connector, but webhook management ships. Lemon Squeezy: Create Webhook registers an endpoint for store events such as order_created, subscription_created, and subscription_payment_success, and it can point straight at a Mattering inbound webhook trigger so sales start automations. You supply the signing secret and the API never returns it, so keep your own copy. For everything else, the honest pattern is polling: run Lemon Squeezy: List Orders or Lemon Squeezy: List Subscriptions on a schedule and act on what changed.

Why do node outputs look like data.data.attributes?

Because the Lemon Squeezy API follows the JSON:API specification and the connector surfaces responses as-is rather than flattening them. A single record sits at data.data.attributes, list items sit under data.data with attributes each, and pagination lives at data.meta.page. The upside is that captured outputs match Lemon Squeezy's own API documentation exactly. Money fields are integer cents with formatted twins, so 100 on a USD order arrives alongside a display-ready $1.00.

Is the Lemon Squeezy API still maintained after the Stripe acquisition?

Yes. Lemon Squeezy is a Stripe company, and its API is alive and actively maintained: the public changelog carries entries into July 2026, and no sunset or deprecation of the API has been announced. This connector targets the current, documented surface, and its read nodes cover the data an export would need if plans ever change.

38 nodes waiting on the canvas

Put Lemon Squeezy to work inside your workspace

Connect once, then use every node in visual automations and AI agent workflows across the Mattering platform.

All product names, logos, and brands are property of their respective owners and are used for identification purposes only. Use of these names, logos, and brands does not imply endorsement or affiliation. Lemon Squeezy is a product of its respective owner; Mattering is an independent platform.

Start Free Explore our Products