Telegram Archive
● Activeio.github.GeiserX/telegram-archive-mcp
Search and read your archived Telegram chats and messages
Connect this server
One click to install, or copy the config below. Suits: Claude Desktop · Cursor.
Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):
{
"mcpServers": {
"telegram-archive-mcp": {
"command": "npx",
"args": [
"-y",
"telegram-archive-mcp@0.4.2"
],
"env": {
"TELEGRAM_ARCHIVE_URL": "<your TELEGRAM_ARCHIVE_URL>",
"TELEGRAM_ARCHIVE_PASS": "<your TELEGRAM_ARCHIVE_PASS>"
}
}
}
}claude mcp add --env TELEGRAM_ARCHIVE_URL='<your TELEGRAM_ARCHIVE_URL>' --env TELEGRAM_ARCHIVE_PASS='<your TELEGRAM_ARCHIVE_PASS>' --transport stdio telegram-archive-mcp -- npx -y telegram-archive-mcp@0.4.2codex mcp add telegram-archive-mcp --env TELEGRAM_ARCHIVE_URL='<your TELEGRAM_ARCHIVE_URL>' --env TELEGRAM_ARCHIVE_PASS='<your TELEGRAM_ARCHIVE_PASS>' -- npx -y telegram-archive-mcp@0.4.2code --add-mcp '{"name":"telegram-archive-mcp","type":"stdio","command":"npx","args":["-y","telegram-archive-mcp@0.4.2"],"env":{"TELEGRAM_ARCHIVE_URL":"<your TELEGRAM_ARCHIVE_URL>","TELEGRAM_ARCHIVE_PASS":"<your TELEGRAM_ARCHIVE_PASS>"}}'Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.
- TELEGRAM_ARCHIVE_URLrequiredTelegram Archive instance URL (e.g. http://localhost:8000)
- TELEGRAM_ARCHIVE_PASSsecretTelegram Archive login password
A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.
- Category
- Communication
- Version
- 0.4.2
- Registry
- active
- Published
- 11/12/2026
On GitHub
read Nov 18, 2026- Stars
- 15
- Forks
- 2
- Last push
- Nov 11, 2026
- License
- GPL-3.0
Goai-toolsarchivechat-archivechat-backupchat-historyclaude-desktopdatahoarderjson-rpcmcp-servermcp-toolsmessage-searchmessagingmodel-context-protocolsearchself-hostedstdiotelegramtelegram-archivetelegram-backuptelegram-search
From the README
telegram-archive-mcp An MCP server for any Telegram-Archive instance. LLMs use it to search messages, browse chats and read archived Telegram history. Features • Speaks MCP 2026-07-28 and every earlier revision down to 2024-11-05 on stdio and Streamable HTTP. Clients that still use the initialize handshake work unchanged. • Search one chat or every chat at once, read a chat page by page, one calendar day in your timezone, or the conversation around one message. • Forum topics, pinned messages, folders and per-chat statistics. • The photo attached to a message, returned as an image the model can look at and scaled to 1568 pixels when larger (get_media). • Every tool is read-only except refreshstats; READONLY=1 hides that one too. • Signs in to Telegram-Archive through /api/login with TELEGRAMARCHIVEUSER and TELEGRAMARCHIVEPASS. • HTTP listens on loopback by default, checks Origin, caps request bodies, and requires MCPAUTHTOKEN on any other address. • Ships as an npm package, a Docker image and multi-arch Go binaries. Install Every client below runs the server over stdio.…
Read the full README on GitHub →Alternatives to Telegram Archive
Best Communication servers →The most-starred Communication servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| Inbox Zero | 13,026 | Nov 2026 | Needs sign-in |
| Agent-Native Brain | 7,707 | Nov 2026 | Needs sign-in |
| Agent-Native Chat | 7,707 | Nov 2026 | Needs sign-in |
| Agent-Native Dispatch | 7,707 | Nov 2026 | Needs sign-in |
| Agent-Native Mail | 7,707 | Nov 2026 | Needs sign-in |
Telegram Archive: questions people ask
- Is Telegram Archive a remote or a local MCP server?
- According to its entry in the official MCP registry, Telegram Archive ships as a local package (npm, Docker) that your client starts on your machine.
- Does Telegram Archive need an API key?
- Its registry entry declares 4 required environment variables: TELEGRAM_ARCHIVE_URL, TELEGRAM_ARCHIVE_PASS, TELEGRAM_ARCHIVE_URL, TELEGRAM_ARCHIVE_PASS. The config on this page shows where each goes.
- Is Telegram Archive still maintained?
- Active: the repository's last commit 8 days ago. Last push Nov 11, 2026, 15 GitHub stars, GPL-3.0 licence. Read from GitHub on Nov 18, 2026.
- How do I add Telegram Archive to Claude, Cursor or VS Code?
- Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
More Communication servers
Browse all Communication →Company Social MCP: Website to LinkedIn & Social Links
GeminiGeorge22
Find a company's LinkedIn, X, YouTube, Instagram and Facebook profiles from its website or name.
Genudo
genudo-ai
Build & manage Genudo AI agents for any messaging channel — pipelines, integrations, knowledge.
MCP Gera Clone
geraservicesuk
GeraClone MCP — discover expert clones, check operator's clone status, start expert chats (consent).
Dial
GetDial-AI
Communication stack for AI agents: SMS, AI voice calls, phone numbers, and account events.
Squish
getsquish
Give AI random access to video: timestamped contact sheets + zoom into any start/end range.
Buddy phone tools
ghorbelhamdi
Android phone tools for AI agents (read the screen, tap, type, open apps), served by the Buddy app.
Add the badge to your site
Show visitors that Telegram Archive is listed here — it’s also the link we check for a free listing.
HTML — for your website
<a href="https://serverdex.io/server/io-github-geiserx-telegram-archive-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Telegram Archive — listed on Serverdex" width="123" height="40" loading="lazy"></a>Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.
Markdown — for your README
[](https://serverdex.io/server/io-github-geiserx-telegram-archive-mcp?utm_source=badge)Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.