Telegram — MCP server

mcp server

Sends, reads and searches Telegram messages through a user account session (MTProto).

chigwell/telegram-mcplistedunreviewednot running here yet

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

This project does not publish an install method we can turn into a config. Follow the README instead.

Tools provided

As listed by the project. Your agent asks before calling them, depending on its settings.

send_messageSend a message
get_historyRead chat history
search_messagesSearch messages
list_chatsList chats
send_fileSend a file
wait_for_new_messageWait for an incoming message

README

synced Oct 13, 2026

Sends, reads and searches Telegram messages through a user account session (MTProto).

Configuration

Variable	Required	Description
`TELEGRAM_API_ID`	Yes	API ID from my.telegram.org/apps
`TELEGRAM_API_HASH`	Yes	API hash from my.telegram.org/apps
`TELEGRAM_SESSION_STRING`	No	Session string (or TELEGRAM_SESSION_NAME for a file session)
`TELEGRAM_EXPOSED_TOOLS`	No	Set to read-only to expose only read tools

Tools

send_message — Send a message
get_history — Read chat history
search_messages — Search messages
list_chats — List chats
send_file — Send a file
wait_for_new_message — Wait for an incoming message

About this listing

Details were gathered from the project's public pages on 2026-10-13 and have not been reviewed by a person yet. Read the project's own documentation before giving it access to anything sensitive.

Sources: