Telegram Archive

● Active

io.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.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

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>"
      }
    }
  }
}
One line, from the terminal
Claude Code
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.2
OpenAI Codex CLI
codex 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.2
VS Code
code --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.

Environment variables
  • 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.

ServerStarsLast pushLive check
Inbox Zero13,026Nov 2026Needs sign-in
Agent-Native Brain7,707Nov 2026Needs sign-in
Agent-Native Chat7,707Nov 2026Needs sign-in
Agent-Native Dispatch7,707Nov 2026Needs sign-in
Agent-Native Mail7,707Nov 2026Needs 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.
Browse all Communication →

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.

Telegram Archive — listed on Serverdex

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

[![Telegram Archive — listed on Serverdex](https://serverdex.io/brand/badge.svg)](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.