Telegram MCP
Telegram MCP via MTProto (user account, distinct from a bot). Read messages, send messages, list dialogs, manage contacts, and search history through the same Telegram API the desktop client uses. 1,046 stars, 56 commits on main in the last 30 days.
“Telegram MCP via MTProto (user account, distinct from a bot). Read messages, send messages, list dialogs, manage contacts, and search history through the same Telegram API the desktop client uses. 1,046 GitHub stars and 56 commits on main in the last 30 days. Apache-2.0.”
INSTALL THIS SERVER
{
"mcpServers": {
"telegram": {
"command": "uvx",
"args": [
"telegram-mcp"
],
"env": {
"TELEGRAM_API_ID": "<your-api-id>",
"TELEGRAM_API_HASH": "<your-api-hash>",
"TELEGRAM_SESSION_STRING": "<your-session-string>"
}
}
}
}
{
"mcpServers": {
"telegram": {
"command": "uvx",
"args": [
"telegram-mcp"
],
"env": {
"TELEGRAM_API_ID": "<your-api-id>",
"TELEGRAM_API_HASH": "<your-api-hash>",
"TELEGRAM_SESSION_STRING": "<your-session-string>"
}
}
}
}
{
"mcpServers": {
"telegram": {
"command": "uvx",
"args": [
"telegram-mcp"
],
"env": {
"TELEGRAM_API_ID": "<your-api-id>",
"TELEGRAM_API_HASH": "<your-api-hash>",
"TELEGRAM_SESSION_STRING": "<your-session-string>"
}
}
}
}
{
"mcpServers": {
"telegram": {
"command": "uvx",
"args": [
"telegram-mcp"
],
"env": {
"TELEGRAM_API_ID": "<your-api-id>",
"TELEGRAM_API_HASH": "<your-api-hash>",
"TELEGRAM_SESSION_STRING": "<your-session-string>"
}
}
}
}
{
"mcpServers": {
"telegram": {
"command": "uvx",
"args": [
"telegram-mcp"
],
"env": {
"TELEGRAM_API_ID": "<your-api-id>",
"TELEGRAM_API_HASH": "<your-api-hash>",
"TELEGRAM_SESSION_STRING": "<your-session-string>"
}
}
}
}
8 TOOLS AVAILABLE
OUR ASSESSMENT
- 1,046 GitHub stars and Apache-2.0 licence.
- 56 commits on main in the last 30 days.
- MTProto access: full Telegram user-account capabilities (groups, channels, secret chats, contacts).
- Multi-account setup supported.
- Proxy support via python-socks for restricted networks.
- Prompt injection defences: sanitize_user_content, sanitize_name, sanitize_dict for control-character and length sanitisation.
- Docker deployment supported.
- File path security: read/write paths configurable to avoid agent escape.
- Requires a Telegram session string generated from a phone-number-authenticated user account (distinct from a bot token).
- Telegram TOS considerations: user-account automation has stricter rules than bot-account automation.
- File-system access is broad by default; restrict via the path-security configuration.
The MCP holds a Telegram session string equivalent to full account login. Store it in OS keychain or secrets manager. Scope file paths via the path-security configuration. The prompt-injection defences (sanitize_user_content etc.) reduce risk from incoming messages; the LLM operator should still treat message content as untrusted.
Operators who want agents to interact with Telegram via a user account (channels, groups, secret chats); workflows where Telegram is the primary collaboration channel; teams running multi-account agent setups for Telegram administration.
TECHNICAL DETAILS
ADOPTION METRICS
// Reading this1,046 stars on the chigwell/telegram-mcp repo. 56 commits on main in the last 30 days.
// Reading thisFirst-ranked in communication on commit cadence and MTProto user-account capabilities.
SOURCES & VERIFICATION
We don't take any single directory's word for it. Before scoring, we cross-reference 4 public MCP sources, install the server ourselves against the clients we cover, and record when we last re-verified.
The same server, 4 different lenses. We reconcile these signals into our editorial score, which is why our number sometimes diverges from a directory-aggregate star count.
| Source | Their rating | Their star count | Their downloads | Last synced |
|---|---|---|---|---|
| AutomationSwitch This page | 4.5editorial | 1,046 | — | MAY 3, 2026 |
| PulseMCP | — unrated | unavailable | unavailable | MAY 3, 2026 |
| MCP.so | — unrated | unavailable | unavailable | MAY 3, 2026 |
| Glama | — unrated | unavailable | unavailable | MAY 3, 2026 |
| Smithery | — unrated | unavailable | unavailable | MAY 3, 2026 |
// Counts are directory-reported; we don't adjust them. Discrepancies usually come from different snapshot times or star-caching.
OTHER COMMUNICATION MCP SERVERS
Slack
Team communication layer for reading channels, searching messages, posting updates, and managing threads. Honors Slack rate limits and surfaces ephemeral messages correctly.
Discord MCP
Discord bot integration covering messages, channels, forums, roles, and webhooks. 43-tool surface for Discord server administration. 80 stars and 2 commits on main in the last 30 days, modest cadence places this at Tier 2.
DISCUSS YOUR
MCP REQUIREMENTS.
Evaluating a server, scoping an internal deployment, or working out whether MCP is the right fit at all. Start the conversation and we will point you at the right piece of the ecosystem.