Lemon Squeezy Server

A Model Context Protocol (MCP) server implementation that integrates with Lemon Squeezy for handling subscriptions, checkouts, products, and more. This server provides a structured interface to programmatically manage your Lemon Squeezy store with audit logging and tool-based control.

Demo

Requirements

• Python 3.8+
• MCP SDK 0.1.0+
• aiohttp
• python-dotenv

Components

Resources

The server provides an MCP-compatible resource for operation auditing:

• Stores logs of all tool-based Lemon Squeezy operations
• Exposes audit log via read_resource endpoint
• Helpful for debugging and audit traceability

Tools

Implements a full set of Lemon Squeezy operations via MCP tools:

🔍 Store & Product Tools

• get_user: Get current Lemon Squeezy user info
• list_stores: List all stores
• get_store: Fetch a specific store
• list_products: List products
• get_product: Get product details
• get_product_variants: List variants for a product

📦 Order & Customer Tools

• list_orders: List all orders
• get_order: Get details of an order
• list_customers: List all customers
• get_customer: Fetch customer details

💳 Subscription & License Tools

• list_subscriptions: List subscriptions
• get_subscription: Get a subscription
• list_license_keys: List license keys
• get_license_key: Fetch license key info

🛒 Checkout & Webhook Tools

• create_checkout: Create a fully customized checkout session
• create_webhook: Register a new webhook
• list_webhooks: List all webhooks (filterable by store)

---

Features

• Subscription & Checkout Management
• Webhook Creation & Listing
• Audit Logging of All Actions
• MCP-Compatible Tool & Resource Integration
• Error Feedback and Logging

---

Installation

Installing via Smithery

To install LemonSqueezy Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @atharvagupta2003/mcp-lemonsqueezy --client claude

Install dependencies

python -m venv venv
source venv/bin/activate  # On macOS/Linux
venv\Scripts\activate    # On Windows
pip install -e .

Configuration

Set up the environment variables in a .env file:

LEMON_SQUEEZY_API_KEY=your_lemonsqueezy_api_key

Claude Desktop

Add the server configuration to your Claude Desktop config:

Windows: C:\Users<username>\AppData\Roaming\Claude\claude_desktop_config.json

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "lemonsqueezy": {
      "command": "/Users/hp/.local/bin/uv",
      "description": "Operations with lemonsqueezy payment platform",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src/mcp_lemonsqueezy",
        "run",
        "--with",
        "fastmcp",
        "server.py"
      ],
      "env": {
         "LEMONSQUEEZY_API_KEY": "<YOUR-API-KEY>"
       }
    }
  }
}

Usage

Start the server

uv run src/mcp_lemonsqueezy/server.py

Example MCP Commands

Get Current User

{
  "tool": "get_user",
  "arguments": {}
}

List All Stores

{
  "tool": "list_stores",
  "arguments": {}
}

Get a Store by ID

{
  "tool": "get_store",
  "arguments": {
    "store_id": "164870"
  }
}

Error Handling

The server provides clear error messages for common scenarios:

• 401 Unauthorized: Missing or invalid API key
• 422 Unprocessable Entity: Invalid fields like missing variant/store ID
• 400 Bad Request: Invalid JSON API structure

Development

Testing

Run the MCP Inspector for interactive testing:

npx @modelcontextprotocol/inspector uv run --with fastmcp /ABSOLUTE/PATH/TO/PARENT/FOLDER/src/mcp_lemonsqueezy/server.py

Building

1. Update dependencies:

uv compile pyproject.toml

2. Build package:

uv build

Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

License

This project is licensed under the MIT License - see the LICENSE file for details.