Beeper MCP Addon
juulieen/beeper-mcp-addon
Files and new conversations for Beeper's MCP: send/download attachments, find contacts, start chats.
- tools
- 6
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Nov 12, 2026
Tools
6 toolsPublic tool metadata for what this MCP can expose to an agent.
download_attachmentSaves a message attachment (video, image, audio, document) to disk and returns the local path
Saves a message attachment (video, image, audio, document) to disk and returns the local path
No parameter schema in public metadata yet.
send_fileUploads a local file and sends it to any chat, with an optional caption
Uploads a local file and sends it to any chat, with an optional caption
No parameter schema in public metadata yet.
search_contactsFinds people on an account (WhatsApp, Signal…), including ones you've never chatted with; phone numbers, emails and @usernames are looked up exactly
Finds people on an account (WhatsApp, Signal…), including ones you've never chatted with; phone numbers, emails and @usernames are looked up exactly
No parameter schema in public metadata yet.
start_chatOpens a direct chat with someone and returns its `chatID`, reusing the existing chat if there is one
Opens a direct chat with someone and returns its `chatID`, reusing the existing chat if there is one
No parameter schema in public metadata yet.
delete_messageDeletes (unsends) a message, for everyone when the network allows it
Deletes (unsends) a message, for everyone when the network allows it
No parameter schema in public metadata yet.
wait_for_messageWaits for an incoming message (a reply, say) and returns it, so the assistant doesn't have to poll
Waits for an incoming message (a reply, say) and returns it, so the assistant doesn't have to poll
No parameter schema in public metadata yet.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
BEEPER_ACCESS_TOKENsecretOptional. Without it, run `npx beeper-mcp-addon login` or approve access in Beeper on first use.
Readme
beeper-mcp-addon
Unofficial. Not affiliated with or endorsed by Beeper.
The missing tools for Beeper Desktop's MCP server: files, new conversations, catching up, reactions and edits.
Beeper Desktop ships a built-in MCP server, so an AI assistant can search and send messages across WhatsApp, Signal, Telegram, iMessage and more. It has a few gaps, though:
- It only handles text: the assistant can see that a message holds a video, but it can't open it, and it can't send a photo or a PDF.
- It can only write in existing conversations. To message someone new, you have to send the first message yourself.
- Catching up on many chats takes one call per chat, and it can't see who reacted, react, or fix a message already sent.
The Beeper Client API that runs alongside it already supports all of that. This small MCP server exposes it as ten tools:
Details
- Repository
- github.com/juulieen/beeper-mcp-addon
- Package
beeper-mcp-addon- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active