What is Mcp Lemonsqueezy

mcp-lemonsqueezy is an implementation of a Model Context Protocol (MCP) server that integrates with Lemon Squeezy, allowing users to manage subscriptions, checkouts, products, and more through a structured interface.

Use cases

Use cases include automating subscription management, creating customized checkout experiences, tracking order and customer data, and implementing webhooks for real-time updates.

How to use

To use mcp-lemonsqueezy, ensure you have Python 3.8+, MCP SDK 0.1.0+, aiohttp, and python-dotenv installed. You can then utilize the provided MCP tools to interact with your Lemon Squeezy store programmatically.

Key features

Key features include subscription and checkout management, webhook creation and listing, comprehensive audit logging for operations, and a full set of tools for managing stores, products, orders, customers, subscriptions, and license keys.

Where to use

mcp-lemonsqueezy can be used in e-commerce platforms, subscription services, and any application that requires management of digital products and services through Lemon Squeezy.

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.