draw.io
Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.
Telegram for AI agents: messages, chats, media, and contacts in bot and user-account modes.
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 7/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 19/100 |
Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Telegram MCP for Claude on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "telegram": { "command": "uvx", "args": [ "n24q02m-telegram" ], "env": { "TELEGRAM_BOT_TOKEN": "your-value", "TELEGRAM_API_HASH": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For TELEGRAM_BOT_TOKEN, TELEGRAM_API_HASH, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Telegram MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
SettingsDeveloperEdit Config
{
"mcpServers": {
"telegram": {
"command": "uvx",
"args": [
"n24q02m-telegram"
],
"env": {
"TELEGRAM_BOT_TOKEN": "your-value",
"TELEGRAM_API_HASH": "your-value"
}
}
}
}Paste the key only into the app’s field, never into a chat or to anyone
Use Telegram MCP and tell me what you can do for me, then show me one thing✓ If Claude says it is using Telegram MCP or shows a Telegram MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
TELEGRAM_API_ID Telegram API ID from my.telegram.org (for user mode)Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Telegram MCP yet
Telegram MCP runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect Telegram MCP
B · Others in Chat & email that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code, with some setup first
You need a Telegram MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Telegram MCP for Claude Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user telegram --env TELEGRAM_BOT_TOKEN=your-value --env TELEGRAM_API_HASH=your-value -- uvx n24q02m-telegram 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For TELEGRAM_BOT_TOKEN, TELEGRAM_API_HASH, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Telegram MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user telegram --env TELEGRAM_BOT_TOKEN=your-value --env TELEGRAM_API_HASH=your-value -- uvx n24q02m-telegramReplace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
You should see Telegram MCP listed as connected
Use Telegram MCP and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Telegram MCP or shows a Telegram MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
TELEGRAM_API_ID Telegram API ID from my.telegram.org (for user mode)Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
You need a Telegram MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Telegram MCP for Cursor on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "telegram": { "command": "uvx", "args": [ "n24q02m-telegram" ], "env": { "TELEGRAM_BOT_TOKEN": "your-value", "TELEGRAM_API_HASH": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For TELEGRAM_BOT_TOKEN, TELEGRAM_API_HASH, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Telegram MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
In the Telegram MCP settings, TELEGRAM_BOT_TOKEN, TELEGRAM_API_HASH is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Telegram MCP and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Telegram MCP or shows a Telegram MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
TELEGRAM_API_ID Telegram API ID from my.telegram.org (for user mode)Descriptions are as written by the maker.
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
You need a Telegram MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Telegram MCP for VS Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "telegram": { "type": "stdio", "command": "uvx", "args": [ "n24q02m-telegram" ], "env": { "TELEGRAM_BOT_TOKEN": "your-value", "TELEGRAM_API_HASH": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For TELEGRAM_BOT_TOKEN, TELEGRAM_API_HASH, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Telegram MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
In the Telegram MCP settings, TELEGRAM_BOT_TOKEN, TELEGRAM_API_HASH is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Telegram MCP and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Telegram MCP or shows a Telegram MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
TELEGRAM_API_ID Telegram API ID from my.telegram.org (for user mode)Descriptions are as written by the maker.
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
JSON settings are under “For developers” below
Claude Code
claude mcp add --scope user telegram --env TELEGRAM_BOT_TOKEN=your-value --env TELEGRAM_API_HASH=your-value -- uvx n24q02m-telegramClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"telegram": {
"command": "uvx",
"args": [
"n24q02m-telegram"
],
"env": {
"TELEGRAM_BOT_TOKEN": "your-value",
"TELEGRAM_API_HASH": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"telegram": {
"command": "uvx",
"args": [
"n24q02m-telegram"
],
"env": {
"TELEGRAM_BOT_TOKEN": "your-value",
"TELEGRAM_API_HASH": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"telegram": {
"type": "stdio",
"command": "uvx",
"args": [
"n24q02m-telegram"
],
"env": {
"TELEGRAM_BOT_TOKEN": "your-value",
"TELEGRAM_API_HASH": "your-value"
}
}
}
}TELEGRAM_BOT_TOKEN secret required envTELEGRAM_API_ID envTELEGRAM_API_HASH secret required envDescriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
pypi: n24q02m-telegramoci: docker.io/n24q02m/telegram:latestBased on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 16, 2026
The registry name was verified with the GitHub account n24q02m, which owns the repo
Code last changed yesterday
Uses Apache-2.0
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
No entries on OSV.dev for n24q02m-telegram@4.24.0
Checks only this package version, not every dependency · checked Nov 15, 2026
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/n24q02m-telegram)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: TELEGRAM_BOT_TOKEN, TELEGRAM_API_HASH
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed yesterday, and the latest version (4.24.0) reached the registry 4 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv), Docker on your computer.
In the same category: draw.io, Vexa, emailmd, Kite Discord Bot Builder, e2a — email for AI agents
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.
Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.
Build and fix Discord bots from a chat. Kite hosts them 24/7, with no code to deploy.
Authenticated email gateway for AI agents — per-agent inboxes, HITL approval, SPF/DKIM verified.
| This one Telegram MCP | draw.io | Vexa | emailmd | Kite Discord Bot Builder | e2a — email for AI agents | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Cloud or install on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install |
| Needs a key | Yes | No | Yes | No | No | No |
| Add with + in Claude | No | No | No | No | No | No |
| Basic checks | 3/3 | 4/4 | 2/4 | 5/5 | 4/4 | 4/4 |
| License | Apache-2.0 | Apache-2.0 | Apache-2.0 | MIT | AGPL-3.0 | Apache-2.0 |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
mcp-name: io.github.n24q02m/telegram
Telegram for AI agents: messages, chats, media, and contacts in bot and user-account modes.
Sister projects from n24q02m (click to expand)
| Project | Tagline | Tag |
|---|---|---|
| agent-chat-plugin | Peer AI agents chat in a shared folder — no human relay, no orchestrator, wor... | Tooling |
| better-code-review-graph | Knowledge graph for token-efficient code reviews -- semantic search and call-... | MCP |
| better-drive | 2-way Google Drive sync with .driveignore filter — rclone engine, Windows tray | Tooling |
| better-email-mcp | IMAP/SMTP email for AI agents -- read, send, organize folders, and manage att... | MCP |
| better-godot-mcp | Composite MCP server for Godot Engine -- 17 composite tools for AI-assisted g... | MCP |
| better-notion-mcp | Markdown-first Notion for AI agents -- pages, databases, blocks, and comments... | MCP |
| better-semantic-release | Drop-in python-semantic-release fork with built-in release-safety guards (orp... | Tooling |
| telegram | Telegram for AI agents -- messages, chats, media, and contacts across both bo... | MCP |
| better-workspace-mcp | Google Workspace MCP server (Docs/Drive/Calendar/Gmail/Sheets/Slides/Tasks/Ch... | MCP |
| claude-plugins | Claude Code plugin marketplace for the n24q02m MCP servers -- install web sea... | Marketplace |
| imagine-mcp | Image and video understanding + generation for AI agents -- across Gemini, Op... | MCP |
| jules-task-archiver | Chrome Extension for bulk operations on Jules tasks via batchexecute API -- a... | Tooling |
| mcp-core | Shared foundation for building MCP servers -- Streamable HTTP transport, OAut... | MCP |
| mnemo-mcp | Persistent AI memory with hybrid search and embedded sync. Open, free, unlimi... | MCP |
| qwen3-embed | Lightweight Qwen3 text embedding and reranking via ONNX Runtime and GGUF | Library |
| skret | Secrets without the server. | CLI |
| tacet | A self-distilling neuro-symbolic cascade that amortises LLM cost across knowl... | Tooling |
| web-core | Shared web infrastructure package for search, scraping, HTTP security, and st... | Library |
| wet-mcp | Open-source MCP server for AI agents: web search, content extraction, and lib... | MCP |
message, chat, media, contact, config, helptelegram auth handles the bot token, or phone + OTP + 2FA, on the machine that runs the serverreadOnlyHint, destructiveHint, idempotentHint, openWorldHinttelegram://docs/* resources# Claude Code plugin (stdio, bot mode)
/plugin marketplace add n24q02m/claude-plugins /plugin install telegram@n24q02m-plugins
claude mcp add telegram -e TELEGRAM_BOT_TOKEN=123456:ABC-DEF -- uvx n24q02m-telegram
docker run -i --rm -e TELEGRAM_BOT_TOKEN=123456:ABC-DEF n24q02m/telegram
The package is n24q02m-telegram (formerly better-telegram-mcp; the old package receives one final release then freezes). The MCP Registry id is io.github.n24q02m/telegram, the Docker image is n24q02m/telegram, and the legacy better-telegram-mcp command is kept as an alias of telegram. The pre-rename registry entry io.github.n24q02m/better-telegram-mcp stays frozen in the registry and is never republished. Local data moves once from ~/.better-telegram-mcp to ~/.telegram on first start.
| Client | Install |
|---|---|
| Claude Code | /plugin marketplace add n24q02m/claude-plugins + /plugin install telegram@n24q02m-plugins (stdio bot mode), or claude mcp add as in the block above |
| Cursor / Windsurf / Gemini CLI / any MCP client | mcpServers JSON in the client's config: stdio command, or type: "http" + url pointing at a server you run (see HTTP mode) |
Install with AI agent -- paste this to your AI coding agent:
Install MCP server
telegramfollowing the steps at
https://raw.githubusercontent.com/n24q02m/claude-plugins/main/plugins/telegram/setup-with-agent.md
Credentials are configured on the machine that runs the server.
Bot mode: set TELEGRAM_BOT_TOKEN in the client config, or save it once:
telegram auth --bot-token 123456:ABC-DEF
User mode: sign in interactively with your phone number. Telegram sends an OTP; a 2FA password is prompted if the account has one. The Telethon session is stored on disk.
telegram auth --phone +15551234567
Check the result with telegram status. The server reads saved credentials at startup, so restart it after telegram auth. Without any credentials the stdio server prints these instructions to stderr and exits with status 1.
Also listed on Smithery. Per smithery.yaml, Smithery starts the server over stdio with uvx --python 3.13 n24q02m-telegram and takes no install-time configuration (empty configSchema). Credentials come from the TELEGRAM_BOT_TOKEN env var or a prior telegram auth (see Setup).
Settings load from TELEGRAM_-prefixed environment variables (Pydantic Settings). Env vars take precedence over credentials saved by telegram auth.
| Variable | Required | Description |
|---|---|---|
TELEGRAM_BOT_TOKEN | Bot mode | Bot token from @BotFather (format 123456789:ABCdef...) |
TELEGRAM_PHONE | User mode | Phone number in + form |
TELEGRAM_API_ID / TELEGRAM_API_HASH | No | Override the bundled public API pair |
USE_BUNDLED_TELEGRAM_CLIENT | No | Set to false to require your own API pair |
TELEGRAM_SESSION_NAME | No | Telethon session file name (default default) |
TELEGRAM_DATA_DIR | No | Session directory (default ~/.telegram) |
MCP_TRANSPORT | No | Set to http to start in HTTP mode (--http or TRANSPORT_MODE=http also work) |
There is no TELEGRAM_PASSWORD env var: telegram auth prompts for the 2FA password and never stores it in the environment.
telegram --http serves MCP at /mcp and an unauthenticated GET /health. Settings live in ~/.telegram/config.toml:
[server]
host = "127.0.0.1" # default; --host overrides port = 8000 # default; --port overrides auth = "token" # "no-auth" | "token" | "multi" token_hash = "scrypt$..."
auth | Who can connect | Credentials used |
|---|---|---|
no-auth | Anyone who can reach the port; loopback binds only (a non-loopback host is refused) | The default credentials |
token | Clients sending Authorization: Bearer matching token_hash | The default credentials |
multi | Users listed in users.toml (default ~/.telegram/users.toml), each with their own token | Each user's own namespace |
Create a token hash with telegram token hash (it reads the token from stdin or a prompt, never from the command line). In multi mode, add users by editing users.toml and restarting the server:
[users.alice]
token_hash = "scrypt$..." enabled = true namespace = "alice"
Then authorize Telegram for that user on the server machine:
telegram auth --phone +15551234567 --user alice
To reach a server on another machine, put it behind a TLS-terminating reverse proxy or a private network and use token or multi auth.
The telegram console script (installed by uvx / pip; better-telegram-mcp is a legacy alias) starts the MCP server when run without a subcommand. Flags that are not a subcommand are passed through to the server (for example --http, --host, --port).
telegram # start the MCP server (stdio)
telegram --http # start in HTTP mode telegram --version # print the version
| Subcommand | Usage | Description |
|---|---|---|
auth | auth --bot-token or auth --phone <+number>, optional --user | Authorize this machine. Bot mode validates the token; phone mode runs the interactive OTP/2FA flow and stores the Telethon session on disk |
login | Same arguments as auth | Deprecated alias of auth |
logout | logout [--yes] [--user ] | Revoke the Telegram session, delete the session file and the saved credentials |
| `c