io.github.tolboy

telegram-mcp-tdlib

Telegram MCP Server

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

stdiocommunityservice

Package Details

ghcr.io/tolboy/telegram-mcp-tdlib:1.8.2-stdio

https://github.com/tolboy/telegram-mcp-tdlib/pkgs/container/telegram-mcp-tdlib
Transportstdio

Environment Variables

TDLIB_API_ID(str)
Required

Telegram API ID from my.telegram.org

TDLIB_API_HASH(str)
RequiredSecret

Telegram API hash from my.telegram.org

TDLIB_PHONE_NUMBER(str)
Secret

Telegram phone number; omit after preparing a persisted session when using QR authentication

TDLIB_AUTH_CODE(str)
Secret

One-time Telegram login code for a fresh headless container

TDLIB_2FA_PASSWORD(str)
Secret

Telegram 2FA password when the account requires it

MCP_READ_ONLY(str)
Default:true

Keep true for safe first use

MCP_TOOL_PROFILE(str)
Default:reader

Tool surface: reader, inbox, community-admin, research, or all