AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Home/
MCP Servers/
telegram-mcp
telegram-mcp logo

telegram-mcp

Active·★ 1.9k·Apache-2.0·Updated 2026-10-21
★ Trending

telegram-mcp connects an MCP client to a Telegram user account through Telethon. It exposes more than 80 tools across accounts, chats and groups, messages, contacts, media, folders and admin operations, so an assistant can read and summarize chats, search history, manage groups and send or edit messages.

Setup needs Telegram API credentials from my.telegram.org and a session string, which the repository's generator script creates by phone or QR code. The server can run from a clone with uv or in Docker, and supports several accounts, proxies and a device identity setting.

Several features limit what an agent can do by mistake: a chat allowlist, file path restrictions, an expected-account check, and contact aliases where only an exact saved name sends a message while similar names only produce a suggestion. The project also ships workflow guides, such as drafting replies without sending them.

This write-up is based on the project's README and public repository data. We have not hand-tested the tool. Data as of 2026-10-18.

License
Apache-2.0
Latest release
v3.2.88 · 2026-10-18
Last commit
2026-10-18
Contributors
92
Forks
471
Open issues and PRs
30
First published
2025-03-20

Source: GitHub, npm and PyPI public APIs.

#admin#api#chat-management#contacts#groups#mcp#mcp-servers#media
$ Install
$ git clone https://github.com/chigwell/telegram-mcp.git && cd telegram-mcp && uv sync && uv run session_string_generator.py
↗ Visit site★ GitHub
01

Features

0180+ MCP tools for chats, groups, messages, contacts, media, folders and admin
02Send, schedule, edit, forward, pin, search messages and manage polls and reactions
03Multi-account routing and proxy support
04Chat access allowlist and file path restrictions for safer use
05Contact aliases: only an exact saved name sends, similar names only suggest
02

Why choose it

+Broad coverage: more than 80 tools for chats, groups, messages, contacts, media, folders and admin tasks.
+Safety controls such as a chat allowlist, file path limits and exact-match contact aliases reduce the risk of messages going to the wrong chat.
+Multi-account routing, proxy support and a Docker option for running it as a service.
03

Trade-offs

!It acts as your own user account, so an agent mistake can send, edit or delete real messages; the allowlist needs to be configured deliberately.
!Setup involves API credentials and generating a session string, which is more work than a hosted integration.
!Rich formatting modes require Telegram Premium on the account.
04

Maintenance check

ActiveChecked: 2026-10-22
Last commit
2026-10-21
Commits, last 90 days
100+
Releases, last 90 days
30
Latest release
v3.2.97 (2026-10-21)
Open issues
38
Recent issues with at least one comment
1/7
Commits per week, last 12 weeks
Commits per week, last 12 weeks: 13, 4, 14, 3, 9, 5, 10, 11, 20, 28, 52, 11

Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.

Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.

Most discussed open issues

  • #317 Question: outgoing messages disappeared across multiple private chats2 comments · 2026-10-16
  • #56 mcp configuration for codker2 comments · 2026-01-29
  • #116 Feature request: Per-chat read/write allowlists with web-based configuration UI1 comments · 2026-05-02
  • #359 Cancelled tool calls still get a "Request cancelled" reply, which breaks the stdio connection in Claude Code0 comments · 2026-10-22
  • #355 send_file: videos arrive squashed into a square, with 0:00 duration and no preview0 comments · 2026-10-22

Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.

05

Compatibility

Claude Desktop
MCP
Verified via docs
Cursor
MCP
Verified via docs
Docker
Docker image
Verified via docs
06

Quick start

1
$ git clone https://github.com/chigwell/telegram-mcp.git
2
$ cd telegram-mcp
3
$ uv sync
4
$ uv run session_string_generator.py
07

Use cases

↳Summarize unread Telegram messages with Claude
↳Draft replies for review without sending
↳Manage Telegram groups and channels from an AI assistant
08

Alternatives

⚡Top VS:
VSregistry★7.4k→VSmcp-searxng★1.3k→VSmcp-remote★1.6k→VSofficial-mcp-servers★378→
registry logo
registry★ 7.4k
A community driven registry service for Model Context Protocol (MCP) servers.
VSCompare→
mcp-searxng logo
mcp-searxng★ 1.3k
MCP Server for SearXNG
VSCompare→
mcp-remote logo
mcp-remote★ 1.6k
Connect an MCP Client that only supports local (stdio) servers to a Remote MCP Server.
VSCompare→
official-mcp-servers logo
official-mcp-servers★ 378
A curated directory of 390+ official MCP servers from the companies behind the products. No unofficial forks, no abandoned projects.
VSCompare→
jira-skill logo
jira-skill★ 88
AI agent plugin for Jira — CLI tools for issues, worklogs, sprints, and more | Server/DC & Cloud
VSCompare→
after-effects-mcp logo
after-effects-mcp★ 85
Agent-driven Adobe After Effects automation. MCP server + CEP plugin enabling Codex/Cursor/Claude Code to drive AE through 30 ae.* tools.
VSCompare→
aicanvas logo
aicanvas★ 68
Open-core registry of animated React components, blocks, design systems, and templates. Real, editable code: install with one shadcn CLI command or let your AI agent pull it over MCP.
VSCompare→
kiso logo
kiso★ 49
Kiso is a publishing engine that turns Open Knowledge Format (OKF) bundles into static websites for humans and AI agents. We also provide an MCP Server.
VSCompare→
See all alternatives →

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs04Maintenance check05Compatibility06Quick start07Use cases08Alternatives
chigwell /
telegram-mcp
↗

Gives Claude, Cursor and other MCP clients access to your Telegram account through 80+ tools built on Telethon

1.9k471Apache-2.0
Last commit2d ago
StatusActive
CategoryMCP Servers
Contributors92
Latest releasev3.2.88
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit
© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.