# LemonSqueezy MCP Server

> LemonSqueezy MCP Server is an open-source MCP server for e-commerce. Ask an agent about LemonSqueezy orders, subscriptions and license keys, with guardrails. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Website:** https://yaw.sh/mcp-servers/lemonsqueezy-mcp/
- **Repository:** https://github.com/yawlabs/lemonsqueezy-mcp
- **MCP Registry name:** io.github.YawLabs/lemonsqueezy-mcp
- **Categories:** e-commerce, finance and payments
- **Listing updated:** 2026-11-14

## About

Coverage spans the LemonSqueezy API: stores, customers, products and variants, orders (including PDF invoices and refunds), subscriptions (plan switch, pause, cancel), subscription invoices, usage records, discounts, license keys and activations, checkouts and webhooks. List calls support JSON:API filtering, pagination and relationship inclusion, and the License API activate, validate and deactivate calls need no API key.

Examples from the site: summing revenue for one plan last month, refunding an order after reading its real total, disabling a license key, and creating a checkout link with custom pricing. It ships as a single bundled file with zero runtime dependencies for quick npx startup.

Set a LemonSqueezy API key, or point LEMONSQUEEZY_API_KEY_COMMAND at a command (for example a vault lookup) so the key never sits in config. Opt-in guardrails cover calls that move money. From Yaw Labs, MIT licensed.

## Features

- **Full API coverage:** Stores, orders, subscriptions, licenses, discounts and webhooks.
- **Money-moving guardrails:** Opt-in controls for refunds and similar calls.
- **Key from a command:** Fetch a short-lived key from a vault at run time.
- **Checkout links:** Create a checkout URL with custom pricing and prefilled data.
- **Metered usage:** Report usage as an increment or absolute value.

## Good for

- Report monthly subscription revenue by plan
- Refund an order for its exact total
- Disable an abused license key
- List webhooks during an outage review

## Install

### Claude Code (Terminal)

```sh
claude mcp add lemonsqueezy-mcp -- npx -y @yawlabs/lemonsqueezy-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "lemonsqueezy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/lemonsqueezy-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "lemonsqueezy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/lemonsqueezy-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "lemonsqueezy-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/lemonsqueezy-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "lemonsqueezy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/lemonsqueezy-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "lemonsqueezy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/lemonsqueezy-mcp"
      ]
    }
  }
}
```

## FAQ

### What credential is needed?

A LemonSqueezy API key from Settings > API.

### Can I avoid storing the key?

Yes, via LEMONSQUEEZY_API_KEY_COMMAND.

### Do license calls need a key?

No, activate, validate and deactivate need none.

### What licence applies?

MIT.

### Is LemonSqueezy MCP Server free?

Yes. LemonSqueezy MCP Server is open source, so you can use and self-host it for free.

### How do I add LemonSqueezy MCP Server to Claude Code?

Run this command in your terminal: claude mcp add lemonsqueezy-mcp -- npx -y @yawlabs/lemonsqueezy-mcp

### What are the best alternatives to LemonSqueezy MCP Server?

The closest alternatives to LemonSqueezy MCP Server are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, O'So MCP Server for PrestaShop, Budget Tracker and SecureCloud.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/lemonsqueezy-mcp-server-2
