Back to Directory/Developer Tools

io.github.JMLEE850623/talktoplanb-mcp

MCP server for TalkToPlanB: list rooms, read & send messages (WhatsApp alternative).

Developer ToolsJavaScriptv1.0.1

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

ToolDescription
whoamiAccount info for the current API key (user id, username, scopes).
list_roomsList your group chats and direct messages (returns room ids).
read_messagesRead recent messages in a room (roomId, optional limit).
send_messageSend a message by roomId or toPhone (plus text).

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

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

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y talktoplanb-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-jmlee850623-talktoplanb-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "talktoplanb-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

talktoplanb-mcpnpm

Compatible MCP Clients

io.github.JMLEE850623/talktoplanb-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More