MCP server

Telegram MCP Server

io.github.tolboy/telegram-mcp-tdlib

Checked 26 Oct 2026, 08:31 UTC · Checked against OSV.dev for malware and vulnerabilities; never run by us

Local-first TDLib Telegram MCP server with 115 tools, account isolation and production guardrails.

Runs on your computer

Source

At a glance

Type: MCP server
Publisher: Not verified
Status: Runs on your computer
Sets up in: Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code
Last checked: 26 Oct 2026, 08:31 UTC

Connect it to your agent

Add to Cursor Add to VS Code VS Code Insiders

Opens the app, which shows the server and asks you to confirm. It then runs the package on your computer with your permissions. For other apps, copy the setup below.

Claude Code

claude mcp add telegram-mcp-tdlib --env TDLIB_API_ID=YOUR_VALUE --env TDLIB_API_HASH=YOUR_VALUE -- docker run -i --rm -e TDLIB_API_ID -e TDLIB_API_HASH ghcr.io/tolboy/telegram-mcp-tdlib:1.17.3-stdio

Claude Desktop

{"mcpServers":{"telegram-mcp-tdlib":{"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_VALUE","TDLIB_API_HASH":"YOUR_VALUE"}}}}

Codex (config.toml)

[mcp_servers.telegram-mcp-tdlib]
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_VALUE", TDLIB_API_HASH = "YOUR_VALUE" }

Gemini CLI

{"mcpServers":{"telegram-mcp-tdlib":{"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_VALUE","TDLIB_API_HASH":"YOUR_VALUE"}}}}

Cursor

{"mcpServers":{"telegram-mcp-tdlib":{"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_VALUE","TDLIB_API_HASH":"YOUR_VALUE"}}}}

VS Code

{"servers":{"telegram-mcp-tdlib":{"type":"stdio","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_VALUE","TDLIB_API_HASH":"YOUR_VALUE"}}}}

Runs on your computer with your permissions: check the package and its source before installing. Replace YOUR_VALUE with your own TDLIB_API_ID, TDLIB_API_HASH.

Browse

Related MCP servers

objekts Production Desk
AI/VFX, CGI, motion & animation production preflight by objekts: locks, continuity, PoCs, estimates.
Awning
Find and book local services, classes and rentals; businesses set up and manage their pages.
raccha.ai
MCP-first toolbox for agents: KV storage, auth, queue, and utility tools. Free in early access.
Diogenes Autonomous Microservice Gateway
Autonomous AI microservices: 55 dynamic guardrails, contract audits & oracles via L402/x402/MPP.
Server and secret guardrails
Local checks for sudo, systemd, sshd, ufw, and secret leaks before an agent applies them.
Receptionist Toolkit
Free receptionist tools: phone scripts, IVR menus (EN+ES), ElevenLabs prompts, missed-call math
arcgate
Arc gateway for agents: token checks, swaps, the ERC-8004 directory, agent boxes, accounts. x402
Support Agent Admin by Nova (CIVAI)
I manage your Support Agent CRM, pipeline analytics, follow-ups, Leads Discovery, and workspace out…

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.tolboy/telegram-mcp-tdlib.svg)](https://aptlynx.net/servers/io.github.tolboy/telegram-mcp-tdlib)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents