Skip to main content
Glama

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).

Related MCP server: pier

1. Get an API key

  1. Open the developer portal: https://talktoplanb.duckdns.org/portal

  2. Register / log in, create a key, and grant the messages:read and messages:send scopes.

  3. 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 start

4. Publish to npm (so npx talktoplanb-mcp works for everyone)

cd mcp-server
npm login
npm publish --access public

After 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).

  • stdout carries the MCP protocol; all logs go to stderr.

  • The server only does what your API key is allowed to do (its scopes).

Available Tools

4 tools
list_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

    A4.4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clear, distinct purpose: listing rooms, reading messages, sending messages, and retrieving account info. No overlap.

    Naming Consistency5/5

    All tool names follow a consistent lowercase snake_case pattern with verb_noun structure (except 'whoami' which is a common command).

    Tool Count5/5

    4 tools is an appropriate count for a messaging server, covering essential operations without being too few or too many.

    Completeness4/5

    Covers core messaging operations (list, read, send) and account info. Minor gaps like room creation/deletion are absent but not critical.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables 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.
      52
      30 npm
      11
      ISC
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Lets 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 npm
      GPL 3.0