Overview

Baremetrics supports the Model Context Protocol (MCP), which allows you to connect your Baremetrics data directly to AI coding tools like Claude Desktop, Cursor, and Codex. Once connected, you can query your metrics, customers, and revenue data conversationally inside your AI tool of choice.

⚠️ Note: Web-based MCP clients (e.g. Claude.ai in the browser) are not yet supported — OAuth support is coming soon. Desktop clients are currently the only ones supported.

What You Need

A Baremetrics account (trial or paid)
Your Baremetrics API key — find it at Settings → API (starts with lk_)
A supported AI tool (Claude Desktop, Claude Code, Cursor, or Codex)

Claude Desktop

⚠️ Security Disclaimer

Using this method means trusting mcp-remote with your API key. It is an open-source tool to bridge the gap for clients that lack native HTTP transport — review it at github.com/geelen/mcp-remote before proceeding.

For Claude Desktop find your claude_desktop_config.json file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

And append the MCP entry alongside your other configuration. Example:

{
  "mcpServers": {
    "baremetrics": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://app.baremetrics.com/mcp",
        "--header",
        "Authorization: Bearer <BM_API_KEY>"
      ]
    }
  },
  [--- existing config ---]
}

Replace <BM_API_KEY> with your live API key from Settings → API
(e.g. lk_*******************)

Claude Code

Simply run the following command in your terminal and the appropriate configuration entry will be added for you.

claude mcp add baremetrics https://app.baremetrics.com/mcp \  
  --transport http \
  --scope user \
  --header "Authorization: Bearer <BM_API_KEY>"

Cursor

Add the MCP entry ~/.cursor/mcp.json. Example:

{
  "mcpServers": {
    "baremetrics": {
      "url": "https://app.baremetrics.com/mcp",
      "headers": {
        "Authorization": "Bearer <BM_API_KEY>"
      }
    }
  }
}

Codex

Add the following to ~/.codex/config.toml:

[mcp_servers.baremetrics]
url = "https://app.baremetrics.com/mcp"
bearer_token_env_var = "BM_API_KEY"

You'll also need to set the BM_API_KEY environment variable in your shell.

Other Clients (STDIO-based)

For AI tools that only support MCP over STDIO (not HTTP), you can use mcp-remote as a proxy (requires Node.js).

Generalized JSON config:

{
  "mcpServers": {
    "baremetrics": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://app.baremetrics.com/mcp",
        "--header",
        "Authorization: Bearer <BM_API_KEY>"
      ]
    }
  }
}

Consult your provider's client documentation for exact file paths and formats.

FAQ

Does this work with ChatGPT / Claude web clients?
No — these clients only support MCP via OAuth. The Baremetrics MCP server only supports header based authentication for the time being, though OAuth support is planned and will be coming soon.

Where do I find my API key?
Go to Settings → API in your Baremetrics dashboard. Your live key starts with lk_.

Does this work on a free trial?
Yes — a Baremetrics trial is all you need to get started.

Disclaimer

⚠️ AI-generated reports: Reports and analysis generated via MCP are produced by fetching raw Baremetrics data which may be in a representation that an LLM could misinterpret. Trends and directional insights should be generally reliable, but we recommend confirming specific numbers against your own exports before making any important business decisions.

Connecting Baremetrics to AI Tools via MCP (Claude, Cursor, Codex)