# Beeper MCP Addon

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10 repo stars
- Author: juulieen
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/juulieen/beeper-mcp-addon
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/beeper-mcp-addon

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `BEEPER_ACCESS_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add beeper-mcp-addon -e BEEPER_ACCESS_TOKEN=<BEEPER_ACCESS_TOKEN> -- npx -y beeper-mcp-addon
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add beeper-mcp-addon --env BEEPER_ACCESS_TOKEN=<BEEPER_ACCESS_TOKEN> -- npx -y beeper-mcp-addon
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "beeper-mcp-addon": {
            "command": "npx",
            "args": [
                "-y",
                "beeper-mcp-addon"
            ],
            "env": {
                "BEEPER_ACCESS_TOKEN": "<BEEPER_ACCESS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e BEEPER_ACCESS_TOKEN=<BEEPER_ACCESS_TOKEN> beeper-mcp-addon npx -y beeper-mcp-addon
```
Replace <…> with your own values

## When to use it
- 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
- Download all photos and videos from this chat into a folder
- Start a new chat with `@username` and send `report.pdf`
- Check who reacted to the latest message in the chat

## Similar
- [beeper](https://affpapa.org/en/nevibecode/skills/beeper.md) — skill · 104 installs
- [blender-addon-development](https://affpapa.org/en/nevibecode/skills/blender-addon-development.md) — skill · 463 installs
- [blender-python-addon](https://affpapa.org/en/nevibecode/skills/blender-python-addon.md) — skill · 111 installs
- [primitive.dev](https://affpapa.org/en/nevibecode/mcp/primitivedev.md) — MCP server · 8352 installs
- [agentmail-cli](https://affpapa.org/en/nevibecode/skills/agentmail-cli.md) — skill · 1700 installs
- [create-phone-number](https://affpapa.org/en/nevibecode/skills/create-phone-number.md) — skill · 973 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
