talktoplanb-mcp
TalkToPlanB MCP Server
Let AI assistants (Claude Desktop, and any Model Context Protocol client) use TalkToPlanB — list chat rooms, read messages, and send messages.
It wraps the TalkToPlanB developer REST API and talks MCP over stdio.
Tools
Tool | Description |
| Account info for the current API key (user id, username, scopes). |
| List your group chats and direct messages (returns room ids). |
| Read recent messages in a room ( |
| Send a message by |
Related MCP server: pier
1. Get an API key
Open the developer portal: https://talktoplanb.duckdns.org/portal
Register / log in, create a key, and grant the
messages:readandmessages:sendscopes.Copy the key (looks like
ttpb_xxxxxxxx...).
2. Use it with Claude Desktop
Add this to your Claude Desktop config
(%APPDATA%\Claude\claude_desktop_config.json on Windows,
~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"talktoplanb": {
"command": "npx",
"args": ["-y", "talktoplanb-mcp"],
"env": {
"TALKTOPLANB_API_KEY": "ttpb_your_key_here"
}
}
}
}Restart Claude Desktop, then try: “List my TalkToPlanB rooms” or “Send a TalkToPlanB message to +60123456789 saying hello.”
Environment variables
Variable | Required | Default |
| ✅ | — |
| ❌ |
|
3. Local development
cd mcp-server
npm install
npm run build # compiles src → dist
TALKTOPLANB_API_KEY=ttpb_... npm start4. Publish to npm (so npx talktoplanb-mcp works for everyone)
cd mcp-server
npm login
npm publish --access publicAfter publishing, you can list it on MCP registries (mcp.so, Glama, Smithery) —
see ../marketing/listing-checklist.md.
Notes
Requires Node.js 18+ (uses the built-in
fetch).stdoutcarries the MCP protocol; all logs go tostderr.The server only does what your API key is allowed to do (its scopes).
Available Tools
4 toolslist_roomsA
List the TalkToPlanB chat rooms (group chats and direct messages) the account belongs to. Returns room ids you can use with read_messages and send_message.
Inputs: no named parameters.
read_messagesA
Read recent messages in a TalkToPlanB room. Provide a roomId obtained from list_rooms.
Inputs: roomId (required), limit.
send_messageA
Send a TalkToPlanB message. Provide text plus EITHER roomId (an existing room from list_rooms) OR toPhone (the recipient’s phone number, which finds or creates a direct message).
Inputs: text (required), roomId, toPhone.
whoamiA
Get information about the TalkToPlanB account that owns the current API key (user id, username, scopes).
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clear, distinct purpose: listing rooms, reading messages, sending messages, and retrieving account info. No overlap.
All tool names follow a consistent lowercase snake_case pattern with verb_noun structure (except 'whoami' which is a common command).
4 tools is an appropriate count for a messaging server, covering essential operations without being too few or too many.
Covers core messaging operations (list, read, send) and account info. Minor gaps like room creation/deletion are absent but not critical.
Related MCP Connectors
Messaging tools for AI agents: send messages, manage chats, groups and channels.
Read, search and reply to your WhatsApp chats from your AI, using your own number.
Send WhatsApp messages and templates, manage chats, contacts, broadcasts and AI agents.
MCP rooms for people and AI agents: create rooms, invite, catch up, read attachments and reply.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI assistants to interact with WhatsApp through the WAHA (WhatsApp HTTP API) platform. Supports chat management, message operations including sending/receiving messages, and marking chats as read.5230 npm11ISC
- AlicenseNot gradedqualityCmaintenanceEnables self-hosted multi-room chat where humans and AI agents interact via MCP, with tools for posting, reading, waiting, listing, creating, and inviting rooms.11 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to send text, media, pre-approved templates, and interactive quick-reply buttons through Meta's official WhatsApp Business Cloud API, check phone quality ratings, list message templates, and call arbitrary Graph API endpoints.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceLets AI assistants read, search, and send WhatsApp messages by linking to an account as a linked device, keeping a searchable archive of chats. It exposes tools for listing and finding chats and contacts, paging through message history, and sending, reacting to, editing, deleting, and marking messages read.49 npmGPL 3.0