v0.5.1

Fix for get_new_messages.

• get_new_messages no longer reads chats that had no new activity since the time you asked about (including empty or never-synced chats). It is faster, returns less noise, and no longer warns wrongly that some chats were left out.

To update: npx -y beeper-mcp-addon@0.5.1 install. Claude Desktop: download beeper-mcp-addon.mcpb below and open it.

v0.5.0

Download every photo and video of a chat over a period, in one call. Includes a security fix: updating is recommended.

• download_attachment can now save a whole period at once. Give chatID + since (and optionally until) instead of a message, and it saves every photo and video of that chat from that period into one folder, oldest first, named by date. The result lists one short line per file (time, sender, message ID). Options:
  • mediaTypes: also documents (file).
  • maxFiles: how many files per call (30 by default; nextSince continues).
  • outputDir: the folder to save into.
    Files already in the folder are skipped, so asking again only fetches what is missing.
• outputPath and outputDir accept ~/ for your home folder.
• Security fix affecting download_attachment and get_new_messages. Updating is recommended.
• Renewing access keeps read + write for tokens saved by older versions (it could fall back to read-only).

To update: npx -y beeper-mcp-addon@0.5.0 install. Claude Desktop: download beeper-mcp-addon.mcpb below and open it.

v0.4.0

Catch up on many chats at once, reactions, edits, and no more silent failure when access expires.

• get_new_messages: everything new since a given time, across all your chats, in one call. One short line per message, so catching up costs little context. Use detail: "counts" to see which chats moved before reading them. Muted chats are included by default. It also says when an account is not connected.
• get_reactions: who reacted to a message, by name. react: add or remove a reaction.
• edit_message: change the text of a message you sent (WhatsApp allows it for 15 minutes).
• Access to Beeper lasts 30 days. You now get a warning 5 days before it ends, and when it ends, the next tool call opens the approval in Beeper again instead of failing. Renewal asks for the same access as before (read-only stays read-only). status shows the expiry date.

To update: npx -y beeper-mcp-addon@0.4.0 install. Claude Desktop: download beeper-mcp-addon.mcpb below and open it.

v0.3.1

Security and reliability fixes. Updating is recommended.

• Security fix in download_attachment, plus hardening of the local sign-in page and of where downloads and converted videos are stored (now a private folder, ~/.cache/beeper-mcp-addon on Linux).
• download_attachment has a new overwrite option (off by default), and your client may ask you to confirm before it saves to a custom path.
• Text coming from other people (message text, names, chat titles) is now length-limited in wait_for_message and watch, and marked as data for the assistant.
• wait_for_message and watch --since no longer miss a reply arriving just as the wait starts.
• macOS: a token saved in the Keychain could be read back wrong.
• Windows: the token is now encrypted (DPAPI) even when the addon starts from PowerShell 7; before, it could fall back to a plain file. Such a file moves to the encrypted store by itself. The login page also opens correctly, and install handles paths with spaces.

To update: npx -y beeper-mcp-addon@0.3.1 install. Claude Desktop: download beeper-mcp-addon.mcpb below and open it.

v0.3.0

• Wait for a reply without polling. New wait_for_message tool: it waits for an incoming message (in one chat, from one person) and returns it, or timeout.
• watch command (npx -y beeper-mcp-addon watch): prints incoming messages in real time, one JSON line each. Ideal for agents that can run a background command, like Claude Code's Monitor tool. The old beeper-watch name still works.
• No missed replies. since (tool) and --since (command) also return messages that arrived just before the wait started.
• The server now tells your assistant how to wait for a reply, with the right command for how the addon was installed.

To update: npx -y beeper-mcp-addon@0.3.0 install. Claude Desktop: download beeper-mcp-addon.mcpb below and open it.

v0.2.0

• Update notice. When you use a tool and a newer version exists, your assistant is told once, with the release notes and the command to update. Nothing updates on its own. Checked at most once a day; turn off with BEEPER_ADDON_NO_UPDATE_CHECK=1.
• Pinned versions. install now writes the exact version (beeper-mcp-addon@0.2.0) into each client's config, so a new release never runs before you choose it. Run npx -y beeper-mcp-addon@0.2.0 install to switch.
• Keyring migration. A token saved to a file moves into the system keyring as soon as one is available.
• install --local points clients at a source checkout.

Claude Desktop: download beeper-mcp-addon.mcpb below and open it.

v0.1.0

First release.

• download_attachment, send_file (videos fixed with ffmpeg when needed), search_contacts, start_chat, delete_message
• beeper-watch: real-time incoming messages as JSON lines
• npx -y beeper-mcp-addon install: one command for Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Kimi Code, Gemini CLI, Codex
• OAuth login through Beeper; token kept in the OS secret store

Claude Desktop: download beeper-mcp-addon.mcpb below and double-click it.