Claude MarketplacesSubmit

Telegram MCP

n24q02m/telegram

A dual-mode Telegram integration that speaks both Bot API (via httpx) and MTProto (via Telethon), so you can automate with a bot token or drive a full user account depending on what you need. Six composite tools cover messaging, chat management, media uploads and downloads, contacts, and config. The web-based OTP flow handles headless auth without manual terminal inputs. Useful when you want Claude to send messages, search history, manage group membership, or pull media from conversations without bouncing between the Telegram app and your workflow. The mode switches automatically based on whether you provide bot credentials or user API keys.

GitHub stars: 11
tools: 6
auth: Secret needed
transport: STDIO
env vars: 3
last updated: Nov 12, 2026

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

messageSend, edit, delete, forward messages. Pin, react, search, browse history

Send, edit, delete, forward messages. Pin, react, search, browse history

No parameter schema in public metadata yet.

chatList and manage chats, groups, channels. Members, admin, forum topics

List and manage chats, groups, channels. Members, admin, forum topics

No parameter schema in public metadata yet.

mediaSend photos, files, voice notes, videos. Download media from messages

Send photos, files, voice notes, videos. Download media from messages

No parameter schema in public metadata yet.

contactList, search, add contacts. Block/unblock users (user mode only)

List, search, add contacts. Block/unblock users (user mode only)

No parameter schema in public metadata yet.

configServer status, runtime settings (message_limit, timeout), cache

Server status, runtime settings (message_limit, timeout), cache

No parameter schema in public metadata yet.

helpFull documentation for any topic

Full documentation for any topic

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly

Agent CaffeineSponsoredClose your lid, come back to finished work

SnugSponsoredThe clipboard manager for the AI era Promote your product hereReach 125k+ visitors monthly

WaxSponsoredBlock anything with supervision, without erasing your iPhone Promote your product hereReach 125k+ visitors monthly

knobsSponsoredSee your site on any phone, any day, in any language

Configuration

TELEGRAM_BOT_TOKENsecret

Telegram bot token from @BotFather (for bot mode)

TELEGRAM_API_ID

Telegram API ID from my.telegram.org (for user mode)

TELEGRAM_API_HASHsecret

Telegram API hash from my.telegram.org (for user mode)

Readme

telegram

mcp-name: io.github.n24q02m/telegram

Telegram for AI agents: messages, chats, media, and contacts in bot and user-account modes.

View the full README on GitHub

Details

Repository: github.com/n24q02m/telegram
Categories: Communication & Messaging, Media & Entertainment
Package: n24q02m-telegram
Transport: STDIO
Auth: Required
Registry: MCP registry, active

More from n24q02m

Related Communication & Messaging MCP servers

1

Smsvirtualsms-io/mcp-serverReal SIM numbers for AI agents: SMS verification, rentals, proxies, cloud browser, x402 deposits.0stars

2

WhatsApp MCP by TimelinesAIinitechsoftware/whatsapp-mcp-by-timelinesaiAsk questions across your WhatsApp inbox from Claude, ChatGPT, Cursor or any MCP client.5stars

3

Email (IMAP/SMTP)boutquin/mcp-server-emailMulti-account IMAP/SMTP email server with 22 tools for reading, sending, searching, and organizing.2stars

4

Faithk7 Gmail Mcpfaithk7/gmail-mcpManage Gmail messages, threads, labels, drafts, and settings from your workflows. Send and organiz…0stars

5

Prelimchat.prelim/prelimRead AI preliminary phone screens — your roles, candidate scores, transcripts, and analytics.0stars

6

Gmailio.github.mcp-z/mcp-gmailGmail integration with OAuth authentication, message search, batch operations, and Sheets export0stars