Telegram Archive
Bridges your Telegram Archive instance to Claude over MCP, exposing message search, chat browsing, and archive statistics as tools and resources. You get search_messages, get_messages, get_pinned_messages, and date-based retrieval alongside read-only URIs for stats, chats, and folders. Built in Go with both stdio and HTTP transports. Auth uses session cookies from the Archive's login endpoint, or bearer tokens for HTTP mode. Useful when you need Claude to dig through archived Telegram history without switching contexts. Requires an existing Telegram Archive deployment, the standalone archival tool from nicmart-dev that backs up messages locally with a web viewer.
- GitHub stars
- 13
- tools
- 12
- auth
- Secret needed
- transport
- STDIO
- env vars
- 4
- last updated
- Nov 12, 2026
Tools
12 toolsPublic tool metadata for what this MCP can expose to an agent.
list_chatsLists chats, most recent first; filter by `search` (name), `archived` or `folder_id`. Each chat's `ref` is the `chat_id` the other tools take.
Lists chats, most recent first; filter by `search` (name), `archived` or `folder_id`. Each chat's `ref` is the `chat_id` the other tools take.
No parameter schema in public metadata yet.
list_foldersLists your Telegram folders and their ids.
Lists your Telegram folders and their ids.
No parameter schema in public metadata yet.
search_all_chatsSearches message text in every chat at once.
Searches message text in every chat at once.
No parameter schema in public metadata yet.
search_messagesSearches one chat, optionally one forum topic.
Searches one chat, optionally one forum topic.
No parameter schema in public metadata yet.
get_messagesReads a chat newest first, by offset or keyset cursor, optionally one forum topic.
Reads a chat newest first, by offset or keyset cursor, optionally one forum topic.
No parameter schema in public metadata yet.
get_message_contextReturns one message with the messages before and after it.
Returns one message with the messages before and after it.
No parameter schema in public metadata yet.
get_messages_by_dateReturns every message of one calendar day in a timezone.
Returns every message of one calendar day in a timezone.
No parameter schema in public metadata yet.
get_pinned_messagesReturns a chat's pinned messages.
Returns a chat's pinned messages.
No parameter schema in public metadata yet.
get_topicsLists a forum group's topics; their ids feed `topic_id`.
Lists a forum group's topics; their ids feed `topic_id`.
No parameter schema in public metadata yet.
get_chat_statsMessage and media counts and size of one chat.
Message and media counts and size of one chat.
No parameter schema in public metadata yet.
get_mediaThe photo attached to a message, as an image, or the file's details.
The photo attached to a message, as an image, or the file's details.
No parameter schema in public metadata yet.
refresh_statsMakes the viewer recalculate archive-wide statistics. Hidden with `READ_ONLY=1`.
Makes the viewer recalculate archive-wide statistics. Hidden with `READ_ONLY=1`.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
TELEGRAM_ARCHIVE_URL*Telegram Archive instance URL (e.g. http://localhost:8000)
TELEGRAM_ARCHIVE_USERTelegram Archive login username
TELEGRAM_ARCHIVE_PASSsecretTelegram Archive login password
READ_ONLYSet to true to hide refresh_stats, the one tool that asks the viewer to do work
Readme
Details
- Repository
- github.com/geiserx/telegram-archive-mcp
- Website
- geiserx.github.io/telegram-archive-mcp
- Categories
- Communication & Messaging, Search & Web Crawling
- Package
telegram-archive-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
More from geiserx
Related Communication & Messaging MCP servers
View all
Gmaildomdomegg/gmail-mcpAllow AI systems to read, send, archive, and manage emails via Gmail.12stars
Multi Gmail Mcpgx-55/multi-gmail-mcpManage multiple Gmail accounts in Claude Desktop — search, send, reply, draft, and organize.11stars
Microsoft Teams APImaxim-mazurok/teams-apiAI-native Microsoft Teams integration — read chats, send messages, search people9stars
Gmailmintmcp/serversA MCP server for Gmail that lets you search, read, and draft emails and replies.0stars
Telegram Notify Mcpparthjadhav/telegram-notify-mcpSend Telegram notifications from AI agents — text, photos, and documents.7stars
Samihalawa Whatsapp Go Mcpsamihalawa/whatsapp-go-mcpScan QR codes and go! No more troublesome autos or APIs! Send text messages, images, links, locati…5stars