Beeper MCP Addon — Claude Code MCP server: what it does
Beeper MCP Addon — an MCP server for Claude Code adds file attachments, new chats, and reactions to Beeper Desktop. The add-on extends native capabilities.
MIT ★ 10 updated 2026-11-16
claude mcp add beeper-mcp-addon -e BEEPER_ACCESS_TOKEN=<BEEPER_ACCESS_TOKEN> -- npx -y beeper-mcp-addonWhat Beeper MCP Addon does
The module exposes the Beeper Client API to your coding assistant. It adds ten tools for file downloads, contact searches, message editing, and reaction tracking alongside the official Beeper MCP server.
Running the server requires Beeper Desktop with its API enabled in developer settings and Node.js 20 or higher. Without the correct access token and active desktop app, the MCP server cannot connect.
Optional ffmpeg support helps fix video playback issues when sending files.
What it helps with
- download media attachments from a chat
- start a new conversation with a contact
- delete or edit a sent message
- search contacts across messaging networks
Example prompts for the agent
- Download all photos and videos from this chat into a folder
- Start a new chat with
@usernameand sendreport.pdf - Check who reacted to the latest message in the chat
How to install Beeper MCP Addon
Platform CLI
claude mcp add beeper-mcp-addon -e BEEPER_ACCESS_TOKEN=<BEEPER_ACCESS_TOKEN> -- npx -y beeper-mcp-addonReplace <…> with your own values
Platform CLI
codex mcp add beeper-mcp-addon --env BEEPER_ACCESS_TOKEN=<BEEPER_ACCESS_TOKEN> -- npx -y beeper-mcp-addonReplace <…> with your own values
Config file
{
"mcpServers": {
"beeper-mcp-addon": {
"command": "npx",
"args": [
"-y",
"beeper-mcp-addon"
],
"env": {
"BEEPER_ACCESS_TOKEN": "<BEEPER_ACCESS_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"beeper-mcp-addon": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"beeper-mcp-addon"
],
"env": {
"BEEPER_ACCESS_TOKEN": "<BEEPER_ACCESS_TOKEN>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e BEEPER_ACCESS_TOKEN=<BEEPER_ACCESS_TOKEN> beeper-mcp-addon npx -y beeper-mcp-addonReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Beeper MCP Addon
How to install Beeper MCP Addon in Claude Code?
Run claude mcp add beeper-mcp-addon -e BEEPER_ACCESS_TOKEN=<BEEPER_ACCESS_TOKEN> -- npx -y beeper-mcp-addon in your terminal.
What does Beeper MCP Addon do?
It adds missing capabilities to Beeper Desktop's MCP server, letting assistants handle files, message reactions, edits, and new chats.
What is needed to run Beeper MCP Addon?
You need Beeper Desktop with API enabled, Node.js 20+, and a valid BEEPER_ACCESS_TOKEN.