Beeper Desktop API

Beeper Desktop API is a fully local API for all your chats across WhatsApp, Instagram, Telegram, Google Messages, Google Voice, Google Chat, Messenger, Signal, LinkedIn, X, Discord, Slack, and more. It comes with an API and SDKs for JavaScript, Python, and Go that allow you to search chats, send messages, and control the Beeper Desktop app.

You can search your message history, send or draft messages, and integrate your desktop app with Beeper Desktop.

Limitations

• Beeper Desktop API runs inside Beeper Desktop and requires Beeper Desktop to be running to be accessible. By default, it can’t be accessed from other devices.
• Message history might be limited. Beeper indexes your messages from the networks in the background, when you first add an account, only recent messages might be available. For best results, prefer using On-Device Connections instead of Beeper Cloud when connecting accounts.
• iMessage is only supported on macOS.
• Beeper Desktop API is still new and evolving.

Get started

1. Install Beeper Desktop

   Desktop API & MCP server are available on Beeper Desktop v4.1.169 and later.

   Download Beeper Desktop

2. Enable & Start Beeper Desktop API

   Open Settings → Developers and toggle Beeper Desktop API to enable it.

   By default, this will start the server on http://localhost:23373 with the built-in MCP server.

Personal use recommended

We recommend Beeper Desktop API for personal use only. Sending too many messages might result in account suspension by the networks.

Actions like searching or fetching existing chats or messages are always local and can be used without limitations.

Start building

The easiest way to get started is to use our TypeScript SDK.

Read the TypeScript SDK docs

You can also use the REST API directly or use the built-in MCP server. Support for more languages coming soon!

Example projects

• Raycast extension

more coming soon

Questions and feedback

• Join our community room on Beeper. In Beeper Desktop, go to Settings → Developers and click “Join Community”. Or join with Matrix.
• You can always reach out to us on help@beeper.com or DM us on X with any questions or feedback.