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. Use the HTTP API or an SDK for TypeScript, Go, Python, or PHP 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.

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.

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.

Get started

If you are looking for the MCP to integrate into apps like Claude Desktop or Codex, see the MCP documentation.

The easiest way to start building with the Desktop API is to ask your agent to use one of the SDKs or the HTTP API.

I want to build an integration with Beeper Desktop API.
Please visit https://developers.beeper.com/desktop-api/index.md
Use the TypeScript, Go, Python, or PHP SDK, or the HTTP API to build it.

Read the TypeScript SDK docs

Read the Go SDK docs

Read the Python SDK docs

Read the PHP SDK docs

The PHP SDK installs through Composer with a Git VCS repository, not Packagist. The PHP SDK docs above include the installation steps.

You can also use the REST API directly or use the built-in MCP server.

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.
• raycast/extensions/extensions/beeper (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 → Integrations 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.