Telegram MCP Server
io.github.tolboy/telegram-mcp-tdlib · version 1.19.1
Community listing. Not installed or verified by cosmic-mcp. Read the source and its permissions before you run it.
Local-first TDLib Telegram MCP server with 126 tools, account isolation and production guardrails.
https://github.com/tolboy/telegram-mcp-tdlibQuick facts
- Listing: Community
- Published Nov 2, 20:47 UTC
- Transport: stdio
- Package: oci
ghcr.io/tolboy/telegram-mcp-tdlib:1.19.1-stdio - Listed by cosmic-mcp: Nov 9, 04:27 UTC
Details
- Repository: https://github.com/tolboy/telegram-mcp-tdlib
- Needs settings:
TDLIB_API_IDTDLIB_API_HASHTDLIB_PHONE_NUMBERTDLIB_AUTH_CODETDLIB_2FA_PASSWORDMCP_READ_ONLYMCP_TOOL_PROFILE
Setup snippets
Generated from the registry entry. cosmic-mcp has not run or reviewed this server; values in angle brackets are yours to fill in.
Run it locally (oci)
docker run -i --rm -e 'MCP_READ_ONLY' -e 'MCP_TOOL_PROFILE' -e 'TDLIB_2FA_PASSWORD' -e 'TDLIB_API_HASH' -e 'TDLIB_API_ID' -e 'TDLIB_AUTH_CODE' -e 'TDLIB_PHONE_NUMBER' 'ghcr.io/tolboy/telegram-mcp-tdlib:1.19.1-stdio'Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"telegram-mcp-tdlib": {
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_READ_ONLY",
"-e",
"MCP_TOOL_PROFILE",
"-e",
"TDLIB_2FA_PASSWORD",
"-e",
"TDLIB_API_HASH",
"-e",
"TDLIB_API_ID",
"-e",
"TDLIB_AUTH_CODE",
"-e",
"TDLIB_PHONE_NUMBER",
"ghcr.io/tolboy/telegram-mcp-tdlib:1.19.1-stdio"
],
"command": "docker",
"env": {
"MCP_READ_ONLY": "<your mcp read only>",
"MCP_TOOL_PROFILE": "<your mcp tool profile>",
"TDLIB_2FA_PASSWORD": "<your tdlib 2fa password>",
"TDLIB_API_HASH": "<your tdlib api hash>",
"TDLIB_API_ID": "<your tdlib api id>",
"TDLIB_AUTH_CODE": "<your tdlib auth code>",
"TDLIB_PHONE_NUMBER": "<your tdlib phone number>"
}
}
}
}Claude Code
claude mcp add 'telegram-mcp-tdlib' -- docker run -i --rm -e 'MCP_READ_ONLY' -e 'MCP_TOOL_PROFILE' -e 'TDLIB_2FA_PASSWORD' -e 'TDLIB_API_HASH' -e 'TDLIB_API_ID' -e 'TDLIB_AUTH_CODE' -e 'TDLIB_PHONE_NUMBER' 'ghcr.io/tolboy/telegram-mcp-tdlib:1.19.1-stdio'Cursor (.cursor/mcp.json)
{
"mcpServers": {
"telegram-mcp-tdlib": {
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_READ_ONLY",
"-e",
"MCP_TOOL_PROFILE",
"-e",
"TDLIB_2FA_PASSWORD",
"-e",
"TDLIB_API_HASH",
"-e",
"TDLIB_API_ID",
"-e",
"TDLIB_AUTH_CODE",
"-e",
"TDLIB_PHONE_NUMBER",
"ghcr.io/tolboy/telegram-mcp-tdlib:1.19.1-stdio"
],
"command": "docker",
"env": {
"MCP_READ_ONLY": "<your mcp read only>",
"MCP_TOOL_PROFILE": "<your mcp tool profile>",
"TDLIB_2FA_PASSWORD": "<your tdlib 2fa password>",
"TDLIB_API_HASH": "<your tdlib api hash>",
"TDLIB_API_ID": "<your tdlib api id>",
"TDLIB_AUTH_CODE": "<your tdlib auth code>",
"TDLIB_PHONE_NUMBER": "<your tdlib phone number>"
}
}
}
}VS Code (.vscode/mcp.json)
{
"servers": {
"telegram-mcp-tdlib": {
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_READ_ONLY",
"-e",
"MCP_TOOL_PROFILE",
"-e",
"TDLIB_2FA_PASSWORD",
"-e",
"TDLIB_API_HASH",
"-e",
"TDLIB_API_ID",
"-e",
"TDLIB_AUTH_CODE",
"-e",
"TDLIB_PHONE_NUMBER",
"ghcr.io/tolboy/telegram-mcp-tdlib:1.19.1-stdio"
],
"command": "docker",
"env": {
"MCP_READ_ONLY": "<your mcp read only>",
"MCP_TOOL_PROFILE": "<your mcp tool profile>",
"TDLIB_2FA_PASSWORD": "<your tdlib 2fa password>",
"TDLIB_API_HASH": "<your tdlib api hash>",
"TDLIB_API_ID": "<your tdlib api id>",
"TDLIB_AUTH_CODE": "<your tdlib auth code>",
"TDLIB_PHONE_NUMBER": "<your tdlib phone number>"
},
"type": "stdio"
}
}
}Related servers
- AnomalyArmor Verified domain
Data observability tools for engineering teams: alerts, freshness, schema drift, lineage, quality. - backengine-mcp Verified domain
Surface customer & prospect context from Slack, email, transcripts and tickets in any MCP client. - AiVikings.ai Verified domain
Find, register, and manage domains from any AI chat or agent - Artil — Email, SMS & Messaging for AI Agents Verified domain
Give AI agents own email inbox, SMS numbers, and workspace accounts to receive and send messages. - Atako Verified domain
Remote MCP server to run your Atako AI agents: chat, projects, files, integrations and channels. - AwrAIter — Telegram channels Verified domain
Telegram channels you administer: analytics, content plans, scheduled publishing. No userbot