Beeper Desktop API

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

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

Limitations

• Only for the next few weeks, Beeper Desktop API is only available on Nightly, it’s the beta version of Beeper Desktop and receives more frequent updates.
• Beeper Desktop API runs inside Beeper Desktop and requires Beeper Desktop to be running to be accesible. 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 not supported. We are planning to bring partial support, only on macOS, in the future.
• Beeper Desktop API is experimental and APIs are subject to change.

Get Started

1. Install Beeper Desktop Nightly

   During early access, Desktop API & MCP server is only available on Nightly, it’s the beta version of Beeper Desktop and receives more frequent updates.

   Download Beeper Desktop Nightly

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.

3. Create an access token and start building

   Click the ”+” button next to “Approved connections” and follow instructions.

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 is always local and can be used without limitations.

Start building

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 & 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.