AI Plugin Index
Telegram MCP Server
CommunityMCP server by tolboy · updated · ★ 10
Local-first TDLib Telegram MCP server with 115 tools, account isolation and production guardrails. Telegram MCP Server is a community project by tolboy, not verified by a company domain.
Last commit 6 days ago
Apache-2.0: permissive, fine for commercial use
Clear description, published package or server URL, original repository
Not checked yet. What we check
What you need
| Setting | Needed | What it is |
|---|---|---|
TDLIB_Environment variable | Required | Telegram API ID from my.telegram.org |
TDLIB_Environment variable, secret | Required | Telegram API hash from my.telegram.org |
TDLIB_Environment variable, secret | Optional | Telegram phone number; omit after preparing a persisted session when using QR authentication |
TDLIB_Environment variable, secret | Optional | One-time Telegram login code for a fresh headless container |
TDLIB_Environment variable, secret | Optional | Telegram 2FA password when the account requires it |
MCP_Environment variable | Optional | Keep true for safe first use Default: true |
MCP_Environment variable | Optional | Tool surface: reader, inbox, community-admin, research, or all Default: reader |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install Telegram MCP Server
Built from the published package, never by AIclaude mcp add telegram-mcp-server -e TDLIB_API_ID=YOUR_TDLIB_API_ID -e TDLIB_API_HASH=YOUR_TDLIB_API_HASH -- docker run -i --rm -e TDLIB_API_ID -e TDLIB_API_HASH ghcr.io/tolboy/telegram-mcp-tdlib:1.17.3-stdioRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"telegram-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TDLIB_API_ID",
"-e",
"TDLIB_API_HASH",
"ghcr.io/tolboy/telegram-mcp-tdlib:1.17.3-stdio"
],
"env": {
"TDLIB_API_ID": "YOUR_TDLIB_API_ID",
"TDLIB_API_HASH": "YOUR_TDLIB_API_HASH"
}
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"telegram-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TDLIB_API_ID",
"-e",
"TDLIB_API_HASH",
"ghcr.io/tolboy/telegram-mcp-tdlib:1.17.3-stdio"
],
"env": {
"TDLIB_API_ID": "YOUR_TDLIB_API_ID",
"TDLIB_API_HASH": "YOUR_TDLIB_API_HASH"
}
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"telegram-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TDLIB_API_ID",
"-e",
"TDLIB_API_HASH",
"ghcr.io/tolboy/telegram-mcp-tdlib:1.17.3-stdio"
],
"env": {
"TDLIB_API_ID": "YOUR_TDLIB_API_ID",
"TDLIB_API_HASH": "YOUR_TDLIB_API_HASH"
}
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add telegram-mcp-server --env TDLIB_API_ID=YOUR_TDLIB_API_ID --env TDLIB_API_HASH=YOUR_TDLIB_API_HASH -- docker run -i --rm -e TDLIB_API_ID -e TDLIB_API_HASH ghcr.io/tolboy/telegram-mcp-tdlib:1.17.3-stdio{
"mcpServers": {
"telegram-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TDLIB_API_ID",
"-e",
"TDLIB_API_HASH",
"ghcr.io/tolboy/telegram-mcp-tdlib:1.17.3-stdio"
],
"env": {
"TDLIB_API_ID": "YOUR_TDLIB_API_ID",
"TDLIB_API_HASH": "YOUR_TDLIB_API_HASH"
}
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
Step-by-step: install Telegram MCP Server in Antigravity CLI
gemini mcp add telegram-mcp-server docker run -i --rm -e TDLIB_API_ID -e TDLIB_API_HASH ghcr.io/tolboy/telegram-mcp-tdlib:1.17.3-stdioGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the telegram-mcp-server block.
Weekly newsletter
Like Telegram MCP Server? Get the best new MCP servers every week
The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.
Alternatives to Telegram MCP Server
All alternatives →
Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Market analysis for AI assistants: screeners, multi-timeframe analysis, backtests, in-chat charts.
Cited company knowledge from Slack, meetings, transcripts, and decisions
Minimal chat-first app with durable threads, actions, and the app-agent loop
Central Slack/Telegram router with jobs, memory, approvals, and A2A delegation
Agent-Native Superhuman - email client with keyboard shortcuts and AI triage
Telegram MCP Server: common questions
How do I install Telegram MCP Server?
In Claude Code run claude mcp add telegram-mcp-server -e TDLIB_API_ID=YOUR_TDLIB_API_ID -e TDLIB_API_HASH=YOUR_TDLIB_API_HASH -- docker run -i --rm -e TDLIB_API_ID -e TDLIB_API_HASH ghcr.io/tolboy/telegram-mcp-tdlib:1.17.3-stdio. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is Telegram MCP Server the official server?
Telegram MCP Server is a community project by tolboy, not verified by a company domain.
Is Telegram MCP Server free?
The code is published under the Apache-2.0 licence. The service it connects to may have its own pricing.
Is Telegram MCP Server safe to use?
It scores 61 of 100. Grades: maintenance A, licence A, quality C. The security check has not run for it yet. Review the code before you install. How grades work.
What are alternatives to Telegram MCP Server?
Similar MCP servers: Vexa, TradingMCP, Agent-Native Brain, Agent-Native Chat.
Does Telegram MCP Server work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.