DialogBrain — Claude Code MCP server: what it does, how to install
DialogBrain — an MCP server that lets an agent search contacts and run conversations across Telegram, WhatsApp, Instagram and email, and manage groups on top of that.
no license 2,553 installs updated 2026-03-11
claude mcp add --transport http dialogbrain https://dialogbrain--dialogbrain.run.toolsWhat DialogBrain does
DialogBrain is one MCP server that connects an agent to your chat channels and email: Telegram, WhatsApp, Instagram and others. The agent can look people up, read and send messages, and handle threads.
The contacts_* tools find a person, show a profile with every linked channel, edit notes and role, merge duplicates and save a lead. contacts_research builds a background brief before first outreach, but it returns no contact channels. The group_* tools search public groups by topic, rate them from 0 to 1 with group_scan, join them, and create new groups on Telegram and WhatsApp. File tools, images_generate and videos_generate are in the set too.
Call order matters. A new person goes through contacts_discover first and contacts_sync second. group_join only works on a group you already found with group_search or added with group_add. group_list shows the discovery list, not your whole inbox, so a chat missing there can still be messaged. The server is remote, at https://dialogbrain--dialogbrain.run.tools.
What it helps with
- look up a person by name or @username and confirm they exist on Telegram or WhatsApp
- pull a background brief on someone before writing to them
- merge a messenger contact and an email contact for the same person
- check a public group's quality before joining
- create a group, add members and promote an admin
Example prompts for the agent
- Use DialogBrain to find the contact Anna and show her full profile
- With DialogBrain, search public Telegram groups about no-code and run
group_scanon the best ones - Research this person through DialogBrain before I message them
How to install DialogBrain
Platform CLI: remote server
claude mcp add --transport http dialogbrain https://dialogbrain--dialogbrain.run.toolsPlatform CLI: remote server
codex mcp add dialogbrain --url https://dialogbrain--dialogbrain.run.toolsConfig file
{
"mcpServers": {
"dialogbrain": {
"url": "https://dialogbrain--dialogbrain.run.tools"
}
}
}Config file
{
"servers": {
"dialogbrain": {
"type": "http",
"url": "https://dialogbrain--dialogbrain.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http dialogbrain https://dialogbrain--dialogbrain.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about DialogBrain
How do I install DialogBrain in Claude Code?
Run claude mcp add --transport http dialogbrain https://dialogbrain--dialogbrain.run.tools. The server connects over HTTP.
What does DialogBrain do?
It gives an agent access to Telegram, WhatsApp, Instagram and email through a single MCP server. The agent can search contacts, handle conversations and manage groups.
How do I add a new person as a contact with DialogBrain?
Call contacts_discover first to find the person by @username or phone on a live channel. Then contacts_sync adds them and opens a thread, returning thread_id and entity_id.