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 Beeper Desktop.

You can search your message history, send or draft messages, and integrate your desktop client 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 SDKs.

Read the TypeScript SDK docs

Read the Go SDK docs

Read the Python SDK docs

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

Projects built on Desktop API

• f/deeper (Swift) - A macOS messaging analytics app for Beeper that connects to the local Beeper Desktop API and visualizes conversations across platforms.
• blqke/beepctl (TypeScript) - CLI for Beeper Desktop API; unified messaging from your terminal, including AI-agent workflows across platforms.
• cameronaaron/beeper-go-sdk (Rust) - Pure Go SDK for the Beeper Desktop API with a chat-archiver CLI tool.
• foeken/beeper-cli (Go) - CLI for Beeper Desktop API.
• mimen/beeper-messaging-tools (TypeScript) - A web app for interacting with the Beeper Desktop API.
• adamanz/omnichannel-messenger (TypeScript) - Multi-platform messaging app using Beeper Desktop API to send messages to WhatsApp, LinkedIn, Slack, and more from one interface.
• BosTheCoder/beeper-wsl-proxy (Python) - Beeper WSL proxy that allows access to the Beeper Desktop API from WSL.
• ErdemGKSL/beeper-desktop-api (Rust) - Beeper Desktop API project (no repo description provided).
• nerveband/beeper-api-cli (Go) - Cross-platform CLI for using your Beeper client from the command line via the Beeper Desktop API.
• beeper/raycast (TypeScript) - Raycast extension built using the Desktop API JS SDK.

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.