English Français العربية

io.github.JMLEE850623/talktoplanb-mcp

Registre officiel Autres

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package talktoplanb-mcp
Claude Code 
claude mcp add talktoplanb-mcp -e 'TALKTOPLANB_API_KEY=<your talktoplanb_api_key>' -- npx -y talktoplanb-mcp@1.0.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "talktoplanb-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "talktoplanb-mcp@1.0.1"
            ],
            "env": {
                "TALKTOPLANB_API_KEY": "<your talktoplanb_api_key>"
            }
        }
    }
}

Variables d'environnement

  • TALKTOPLANB_API_KEY obligatoire secret Your TalkToPlanB API key (ttpb_...), created in the developer portal

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. TalkToPlanB MCP Server
  2. Tools
  3. 1. Get an API key
  4. 2. Use it with Claude Desktop
  5. 3. Local development
  6. 4. Publish to npm (so npx talktoplanb-mcp works for everyone)
  7. Notes

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

Questions fréquentes

Qu'est-ce que io.github.JMLEE850623/talktoplanb-mcp ?

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

Comment installer io.github.JMLEE850623/talktoplanb-mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add talktoplanb-mcp -e 'TALKTOPLANB_API_KEY=<your talktoplanb_api_key>' -- npx -y talktoplanb-mcp@1.0.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.JMLEE850623/talktoplanb-mcp ?

Oui. Il attend TALKTOPLANB_API_KEY, à renseigner dans sa configuration.

io.github.JMLEE850623/talktoplanb-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.JMLEE850623/talktoplanb-mcp ?

Il est publié par JMLEE850623. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.