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:

Install dependencies

Configuration

Set up the environment variables in a .env file:

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

Usage

Start the server

Example MCP Commands

Get Current User

List All Stores

Get a Store by ID

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:

Building

1. Update dependencies:

2. Build package:

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.