LemonSqueezy MCP Server

What LemonSqueezy MCP Server does

LemonSqueezy MCP Server gives MCP-compatible assistants access to Lemon Squeezy store data and selected management operations. It can retrieve the authenticated user, inspect stores, and work with customers, products, variants, prices, downloadable files, orders, order items, subscriptions, and subscription invoices.

Read operations cover individual resources and paginated lists. List tools support filters such as store, product, variant, customer email, order, subscription, or status where applicable. Write operations include creating and editing customers, archiving customers, updating subscriptions, cancelling subscriptions, and issuing order or subscription-invoice refunds. Invoice tools generate PDF download URLs.

How it works

The package runs as an MCP process using stdio transport and forwards tool requests to the Lemon Squeezy API. An assistant can translate a natural-language request into several calls—for example, locating a subscription, inspecting its plan and invoices, and then presenting the relevant figures.

Pagination metadata is returned by list operations; clients should inspect meta.page for the current page, final page, and total. Price resources include an effective_unit_price value. For tiered pricing, unit_price is not the amount charged, while package pricing represents a block of units; the annotated effective value is the safer field for per-unit calculations. When multiple prices exist for a variant, the newest record by created_at is the current one.

Destructive actions have important operational consequences. Order and subscription-invoice refunds are irreversible and use cents as the amount. Subscription cancellation leaves the subscription active through the current billing period. Subscription plan changes, pauses, billing-anchor changes, immediate invoicing, and trial-end changes can affect what a customer pays or when they pay.

Setup and configuration

Install and run the package with:

npx -y @yawlabs/lemonsqueezy-mcp@latest

Node.js 22 or newer is required. Set LEMONSQUEEZY_API_KEY to a key from the Lemon Squeezy dashboard. Claude Desktop and Claude Code can launch the package with npx, passing the API key through the MCP configuration's env object.

A Dockerfile is included for a stdio container deployment. The documented image uses Node 22 Alpine and runs as the non-root node user; the container must receive the API key and an interactive stdin connection. A matching Podman-oriented Containerfile is also available. Smithery can install the package and prompt for environment variables.

Tools and capabilities

Available tool groups include:

• User and store inspection, including store metadata and sales statistics.
• Customer lookup, listing, creation, editing, and reversible archiving.
• Product, variant, price, and downloadable-file discovery.
• Order and order-item lookup, filtered listing, PDF invoice generation, and refunds.
• Subscription and invoice lookup, filtering, plan changes, pausing, cancellation, invoice generation, and refunds.

Store filters and allowlists require care. ls_list_stores returns every store visible to the API key and is not restricted by LEMONSQUEEZY_ALLOWED_STORE_IDS. For several cross-store list operations, setting an allowlist requires a narrowing identifier such as productId, variantId, orderId, or storeId, depending on the tool. A scoped Lemon Squeezy API key remains the actual boundary for store visibility.