Better Telegram MCP

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/n24q02m-better-telegram-mcp

About

Use cases: team-chat

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

1 read · 3 write · 2 delete

Secrets

2 (API keys, tokens or passwords)

Install scripts

None found

Runs as

Python package

Tools (6)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• chatTelegram Chatscan change or delete data

  List, create, join, leave, manage members, settings, and topics. Actions: - list (-> limit=50) - info (chat_id) - create (title -> is_channel) - join (link_or_hash) - leave (chat_id) - members (chat_id -> limit=50) - admin (chat_id, user_id -> demote) - settings (chat_id, title|description) - topics (chat_id, topic_action -> topic_id, topic_name)

• configTelegram Config

  Server configuration and runtime settings. Actions (required params): - status: Show connection state, mode, and current config - set (key+value, or message_limit|timeout): Update a runtime limit. Generic form: set(key='message_limit', value='50'). Typed sugar: set(message_limit=50). - cache_clear: Clear internal caches - setup_status: Show credential state and relay URL - setup_start (-> key='force'): Start relay setup via browser - setup_reset: Clear saved credentials - setup_complete: Re-resolve credentials after relay config

• contactTelegram Contacts

  Manage contacts: list, search, add, and block/unblock users (user mode only). Actions: - list: Show all contacts - search (query): Find contacts by name - add (phone, first_name -> last_name) - block (user_id -> unblock=true)

• helpTelegram Helpread-only

  Get full documentation for any topic. Topics: telegram | messages | chats | media | contacts | all (default: all)

• mediaTelegram Media

  Send photos, files, voice, video, and download media from messages. Actions (file_path_or_url: local path or URL): - send_photo (chat_id, file_path_or_url -> caption) - send_file (chat_id, file_path_or_url -> caption) - send_voice (chat_id, file_path_or_url -> caption) - send_video (chat_id, file_path_or_url -> caption) - download (chat_id, message_id -> output_dir; bot mode also requires file_id)

• messageTelegram Messagescan change or delete data

  Send, edit, delete, forward, pin, react, search, and get message history. Actions (chat_id: "@username" | int): - send (chat_id, text -> reply_to, parse_mode) - edit (chat_id, message_id, text -> parse_mode) - delete (chat_id, message_id) - forward (from_chat, to_chat, message_id) - pin (chat_id, message_id) - react (chat_id, message_id, emoji) - search (query -> chat_id, limit=20) - history (chat_id -> limit=20, offset_id)

Signals

Stars

11

Forks

6

Open issues

1

Weekly downloads

281

Last commit

Oct 11, 2026 (17 days ago)

Last release

Sep 13, 2026 (1 month ago)

Last package publish

Sep 13, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.n24q02m/better-telegram-mcp

Version

4.22.0

Auth

API key

Packages

pypi better-telegram-mcpoci docker.io/n24q02m/better-telegram-mcp:latest

License

Apache-2.0

Repository

github.com/n24q02m/better-telegram-mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql