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 | |---|---| | whoami | Account info for the current API key (user id, username, scopes). | | list_rooms | List your group chats and direct messages (returns room ids). | | read_messages | Read recent messages in a room (roomId, optional limit). | | send_message | Send a message by roomId or toPhone (plus text). |
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 | |---|---|---| | TALKTOPLANB_API_KEY | ✅ | — | | TALKTOPLANB_BASE_URL | ❌ | https://talktoplanb.duckdns.org |
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).
