A local MCP server for Beeper Texts on macOS.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"mcp-beeper-texts","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Beeper Texts MCP Server A local-only MCP (Model Context Protocol) server tested on macOS that exposes Beeper Texts data (messages, contacts, chats) for use with AI assistants and automation tools. Local-only means the MCP accesses your local Beeper SQLite database only, and does not make or trigger **any network requests**. ## Features - **Chat Management**: List and browse conversations across platforms - **Message Access**: Retrieve messages from specific chats - **Search**: Search messages by content, chat name, or by sender - **Media Access**: Fetch attachment bytes/paths via a URI returned in messages - **Multi-Platform Support**: Tested with WhatsApp, Telegram, Signal, Instagram, Twitter/X and LinkedIn. Should work with any Beeper-supported platform. ## Requirements - **macOS only**: This server relies on Beeper Desktop's local database structure only - **Beeper Desktop**: Must be installed, configured with at least one connected account and running to receive new messages - **Python 3.10+**: Required for running the server ## Installation Install from PyPI using pip or uvx: ```bash pip install mcp-beeper-texts ``` Or use uvx for isolated execution: ```bash uvx mcp-beeper-texts ``` ## Configuration ### Claude Desktop Add the following to your Claude Desktop configuration file (`~/Library/Application Support/Claude/claude_desktop_config.json`): ```json { "mcpServers": { "beeper": { "command": "uvx", "args": ["mcp-beeper-texts"] } } } ``` ### Other MCP Clients For other MCP clients, use the command: ```bash uvx mcp-beeper-texts ``` The server communicates over stdio transport. ## TODO Add support for: - [ ] Creating, Editing, and Deleting drafts - [ ] Sending messages - [ ] Sending media attachments ## Available Tools ### `list_chats` List group and DM chats with metadata. - `label` (optional): Filter set: `inbox`, `archive`, `favourite`, `all`, `unread` (default: `inbox`) - `sort_by` (optional): `latest_message…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.