Lemon Squeezy

You can securely connect your AI editor to your Lemon Squeezy account, letting you ask questions about orders, customers, and subscriptions and receive instant answers without leaving your coding environment. This MCP server acts as the bridge between your editor and Lemon Squeezy, enabling natural, in-editor data queries and streamlined workflows.

How to use

Choose your MCP client and configure the server to start querying your Lemon Squeezy data. You can use a quick one-copy-paste setup to run the server directly from the MCP client, or run a local path setup from a development environment. Once configured, you can ask questions like “Show me my last 5 orders” or “Is subscription #12345 still active?” and receive answers within your editor.

How to install

Prerequisites you need before installing the server:

Step-by-step setup

# 1. Clone the project
git clone https://github.com/IntrepidServicesLLC/lemonsqueezy-mcp-server.git
cd lemonsqueezy-mcp-server

# 2. Install dependencies
npm install

# 3. Build the server
npm run build

Configure MCP clients (examples)

You can connect your editor using either a quick one-copy-paste setup or a local path setup. Replace your actual API key where indicated.

"mcpServers": {
  "lemonsqueezy": {
    "command": "npx",
    "args": ["-y", "lemonsqueezy-mcp-server"],
    "env": {
      "LEMONSQUEEZY_API_KEY": "YOUR_KEY_HERE"
    }
  }
}

VS Code (local path) setup

If you use VS Code with a local path, configure a new MCP server with the following settings.

{
  "type": "stdio",
  "name": "lemonsqueezy_mcp_vscode",
  "command": "node",
  "args": ["/absolute/path/to/lemonsqueezy-mcp-server/dist/index.js"],
  "env": {
    "LEMONSQUEEZY_API_KEY": "your_api_key_here"
  }
}

Claude Desktop or other MCP clients (local path)

For Claude Desktop or similar editors, place the same configuration with the path to the built index and restart the editor.

{
  "type": "stdio",
  "name": "lemonsqueezy_mcp_claude",
  "command": "node",
  "args": ["/absolute/path/to/lemonsqueezy-mcp-server/dist/index.js"],
  "env": {
    "LEMONSQUEEZY_API_KEY": "your_api_key_here"
  }
}

Other MCP clients

If your client documents MCP setup differently, run the server with the standard Node command and provide your API key via environment variables.

{
  "type": "stdio",
  "name": "lemonsqueezy_mcp_generic",
  "command": "node",
  "args": ["/absolute/path/to/lemonsqueezy-mcp-server/dist/index.js"],
  "env": {
    "LEMONSQUEEZY_API_KEY": "your_api_key_here"
  }
}

Starting the server and validating

After configuring, start the MCP client and test with a simple query like asking for the last orders. If you see an authentication or connection error, verify your API key and ensure the server built correctly.

Security and best practices

Treat your API key as a secret. Do not expose it in shared or public configurations. Use a dedicated test API key for development when available, and switch to the live key only when you are ready to work with real data.

Troubleshooting

Common issues include misconfigured API keys and build steps. If you encounter a command-not-found error, ensure you ran the build step after installing dependencies. If authentication fails, double-check for stray spaces in the API key.

Logs appear in the MCP Log window of your editor. Review recent messages for specific errors and ensure the server process is running.

Notes

This server provides a direct bridge to Lemon Squeezy data, enabling natural language queries about payments, subscriptions, and customers from your editor.

What you can do with the server

Query recent sales, verify subscription status, locate customers by name, and perform related data lookups directly from your development environment.

Available tools

last_sale_query

Fetches details of the most recent sale to review revenue trends within your editor.

subscription_status_check

Checks whether a given Lemon Squeezy subscription is active or plans for changes.

find_customers_by_name

Finds customers by name for quick customer lookup during support or reporting tasks.