Telegram MCP

- macOS (Apple Silicon):telegram-mcp-darwin-arm64.tar.gz
- macOS (Intel):telegram-mcp-darwin-x64.tar.gz
- Linux:telegram-mcp-linux-x64.tar.gz
- Windows:telegram-mcp-win-x64.exe.zip

Extract the archive and make the binary executable (Unix systems):

tar -xzf telegram-mcp-*.tar.gz chmod +x telegram-mcp

-

Clone the repository and install dependencies:

git clone git@github.com:zhigang1992/telegram-mcp.git cd telegram-mcp bun install

-

Run the initial setup to authenticate with Telegram:

export API_ID=your_api_id export API_HASH=your_api_hash ./telegram-mcp

- Prompt you to enter your phone number
- Send you a verification code via Telegram
- Ask for the verification code
- Display the absolute storage path (you'll need this for MCP configuration)

Note the storage path displayed in the output. It will look something like:

Storage path: /Users/username/telegram-mcp/bot-data/session

Add to your Claude Desktop config using the storage path from the initial setup:

{ "mcpServers": { "telegram": { "command": "/path/to/telegram-mcp", "env": { "API_ID": "your_api_id", "API_HASH": "your_api_hash", "TELEGRAM_STORAGE_PATH": "/absolute/path/from/initial/setup" } } } }

Important: TheTELEGRAM_STORAGE_PATHmust be the absolute path shown during initial setup. This ensures the MCP server uses the authenticated session.

-

messages_sendText- Send a text message to a chat

- chatId(required): Chat/User ID or username
- text(required): Message text to send
- replyToMessageId: Optional message ID to reply to

messages_getHistory- Get message history from a chat

- chatId(required): Chat/User ID or username
- limit: Number of messages (default: 100, max: 100)
- offsetId: Message ID for pagination

- query(required): Search query
- chatId: Specific chat to search in (optional)
- limit: Number of results (default: 50)

messages_getRecent- Get recent messages from all chats

- limit: Number of chats (default: 10)
- messagesPerChat: Messages per chat (default: 10)

- wait_for_reply- Wait for the next message in a chat

- chatId(required): Chat/User ID or username to wait for a message from
- timeoutSeconds: Timeout in seconds (default: 60, max: 300)

-

status_getCurrent- Get the current emoji status for a peer

status_setEmoji- Set or clear an emoji status

- peerId: Target peer, defaults toself
- emojiId: Custom emoji document ID, required unlessclear=true
- isCollectible: SettruewhenemojiIdis a collectible ID
- until: Optional ISO-8601 timestamp or Unix timestamp string
- clear: Clear the current status instead of setting one

status_listAvailable- List available default emoji-status IDs

- scope:selforchannel(default:self)
- limit: Maximum IDs to return (default: 100)

status_listCollectibles- List owned collectible IDs usable as self emoji statuses

- owner: Peer to inspect, defaults toself
- limit: Maximum collectibles to return (default: 100)

- limit: Maximum dialogs (default: 50)
- filter: Filter options (onlyUsers, onlyGroups, onlyChannels)

dialogs_getInfo- Get detailed dialog information

- chatId(required): Chat/User ID or username

The server stores session data inbot-data/directory.

Send and receive emails, SMS, and voice calls via Pingram.

Platfone - Receive SMS & Virtual Numbers MCP

Virtual phone number platform for AI agents — rent numbers across 200+ countries, receive SMS, and manage the full activation lifecycle

MCP server for Telegram bots built with aiogram. 30 tools, 7 resources, 3 prompts — messaging, rich media, moderation, interactive keyboards, real-time event streaming, rate limiting, permissions, and audit logging.

Production-grade MCP server for Telegram with dual-mode Bot API + MTProto, 6 composite tools

Local-first MCP server that puts your own LINE and Telegram chats behind one data layer — a daemon on your machine logs in with your own account, stores messages to JSONL + SQLite/FTS5, and exposes them to MCP clients like Claude Code. Not an npx one-liner: you clone the repo and run the daemon yourself.

Interact with the Didlogic API for telecommunication services, including virtual phone numbers and SMS.

Remote MCP server for managing WhatsApp and Telegram AI assistants: projects, prompts, conversations, leads and analytics, with no destructive tools by design.

Build, edit, and deploy Telegram bots on FlowCastle's hosted visual flow platform.

Read-only public stats for Telegram groups tracked by Limzo — activity, engagement, mood and leaderboards, no API key required.