MCP Server on Beeper Desktop API

Beeper Desktop API includes a built-in MCP (Model Context Protocol) server, enabling seamless integration with AI assistants like Claude Desktop, Claude Code, Cursor, and more.

What is Model Context Protocol?

MCP is an open protocol that standardizes how applications provide context to large language models (LLMs). Think of MCP like a USB-C port for AI applications. Just as USB-C provides a standardized way to connect your devices to various peripherals and accessories, MCP provides a standardized way to connect AI models to different data sources and tools. MCP enables you to build agents and complex workflows on top of LLMs and connects your models with the world.

Learn more about MCP

Before you start, make sure Beeper Desktop API is enabled and running.

Add to your client

Beeper Desktop API supports MCP clients with Streamable HTTP and Server-Sent Events (SSE). Just add the MCP server URL to your client. You’ll be prompted to authenticate when you first connect.

http://localhost:23373/v0/mcp

http://localhost:23373/v0/sse

Authentication

Authentication is handled automatically by Beeper Desktop. When you first connect, the app will prompt for confirmation to allow the MCP client access.

Manually setting the token

If you need to configure authentication manually or having issues with authentication, you can use tokens. See the Authentication Guide for details on how to obtain tokens.

When used with the MCP server, MCP authentication is bypassed and the token is used directly.

Streamable HTTP with custom token

{
  "mcpServers": {
    "beeper": {
      "url": "http://localhost:23373/v0/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

SSE with custom token

{
  "mcpServers": {
    "beeper": {
      "url": "http://localhost:23373/v0/sse",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

stdio via mcp-remote with custom token

{
  "mcpServers": {
    "beeper": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:23373/v0/sse",
        "--header",
        "Authorization: Bearer YOUR_TOKEN_HERE"
      ]
    }
  }
}

Manual setup

Cursor

If you are running on different port, you can setup manually:

Configuration file: ~/.cursor/mcp.json

Streamable HTTP

{
  "mcpServers": {
    "beeper": {
      "url": "http://localhost:23373/v0/mcp"
    }
  }
}

Claude Desktop

How to install Node.js

Node.js lets you run JavaScript programming language outside a browser. Many modern tools depend on it.

macOS
Windows

Download installer: https://nodejs.org → click LTS.
Open the .pkg file and follow steps.
Open Terminal: press ⌘ + Space, type Terminal, hit Enter.
Type:
Check Node.js version
```
node -v
```
You should see a version number.

Download installer: https://nodejs.org → click LTS.
Run the .msi file, keep defaults, finish.
Open Command Prompt: press Windows key, type cmd, hit Enter.
Type:
Check Node.js version
```
node -v
```
You should see a version number.

That means Node.js is installed and in your PATH. You can now use the Beeper Desktop’s MCP server with Claude Desktop.

Prefer using the Connect button in Settings → Developers → MCP → Claude Desktop for auto-installation.

If you want to setup manually:

Configuration file locations:

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

stdio via mcp-remote:

{
  "mcpServers": {
    "beeper": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:23373/v0/sse"
      ]
    }
  }
}

Claude Code

Install globally:

claude mcp add beeper http://localhost:23373/v0/mcp -t http -s user

Install within a directory:

claude mcp add beeper http://localhost:23373/v0/mcp -t http -s local

With manual token:

claude mcp add beeper http://localhost:23373/v0/mcp -t http -H "Authorization: Bearer YOUR_TOKEN_HERE" -s user

VS Code

Configuration file: ~/Library/Application Support/Code/User/settings.json (macOS)

{
  "mcp.servers": {
    "beeper": {
      "url": "http://localhost:23373/v0/mcp"
    }
  }
}

Windsurf

Configuration file: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "beeper": {
      "url": "http://localhost:23373/v0/mcp"
    }
  }
}