Telegram MCP Server

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

Packages and local setup

The published oci package is ghcr.io/tolboy/telegram-mcp-tdlib:1.17.0-stdio. Its declared MCP transport is stdio.

The package declares TDLIB_API_ID (required): Telegram API ID from my.telegram.org; TDLIB_API_HASH (required): Telegram API hash from my.telegram.org; TDLIB_PHONE_NUMBER: Telegram phone number; omit after preparing a persisted session when using QR authentication; TDLIB_AUTH_CODE: One-time Telegram login code for a fresh headless container; TDLIB_2FA_PASSWORD: Telegram 2FA password when the account requires it; MCP_READ_ONLY: Keep true for safe first use; MCP_TOOL_PROFILE: Tool surface: reader, inbox, community-admin, research, or all.

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository. This profile uses version 1.17.0 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related communication MCP servers for tools that cover the same kind of work.