How do I install Telegram Archive?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Telegram Archive need an API key?

The publisher lists these environment variables: TELEGRAM_ARCHIVE_URL, TELEGRAM_ARCHIVE_USER, TELEGRAM_ARCHIVE_PASS.

What transport does Telegram Archive use?

Telegram Archive runs locally over stdio.

Telegram Archive

Q: When was Telegram Archive last checked?

Last checked 2026-10-16. MCP server for Telegram Archive — search messages, browse chats, and access history

by io.github.GeiserX

MCP server for Telegram Archive — search messages, browse chats, and access history

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Local command

npx -y [email protected]

Credentials from the publisher

TELEGRAM_ARCHIVE_URL — Telegram Archive instance URL (e.g. http://localhost:8000)
TELEGRAM_ARCHIVE_USER — Telegram Archive login username
TELEGRAM_ARCHIVE_PASS — Telegram Archive login password

Provider

Claude Code

TELEGRAM_ARCHIVE_URL=<value> TELEGRAM_ARCHIVE_USER=<value> TELEGRAM_ARCHIVE_PASS=<secret> claude mcp add io.github.geiserx-telegram-archive-mcp -- npx -y [email protected]

Run in a terminal.

Claude Desktop

{
  "mcpServers": {
    "io.github.geiserx-telegram-archive-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "TELEGRAM_ARCHIVE_URL": "<value>",
        "TELEGRAM_ARCHIVE_USER": "<value>",
        "TELEGRAM_ARCHIVE_PASS": "<secret>"
      }
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Related MCP

Related skills

View all

Read-only resources for archive stats, chats, folders and health (telegram-archive://stats, telegram-archive://chats).
Message search, message paging by offset or keyset cursor, and whole calendar days in a timezone (get_messages_by_date).
Pinned messages, forum topics 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).
Signs in to Telegram-Archive through /api/login with TELEGRAM_ARCHIVE_USER and TELEGRAM_ARCHIVE_PASS.
One JSON-RPC endpoint (/mcp) over HTTP, or stdio with TRANSPORT=stdio.
Listens on loopback by default; MCP_AUTH_TOKEN adds bearer auth when you expose it.
Ships as a Docker image, an npm package (npx telegram-archive-mcp) and multi-arch Go binaries.

Quick start

npx telegram-archive-mcp

npx fetches the server and runs it on stdio, so your MCP client starts it for you. For Claude Desktop, Cursor or Claude Code, add:

{
  "mcpServers": {
    "telegram-archive": {
      "command": "npx",
      "args": ["-y", "telegram-archive-mcp"],
      "env": {
        "TELEGRAM_ARCHIVE_URL": "http://localhost:8000",
        "TELEGRAM_ARCHIVE_USER": "admin",
        "TELEGRAM_ARCHIVE_PASS": "your-viewer-password"
      }
    }
  }
}

Set the URL, user and password of your Telegram-Archive viewer. Docker Compose (HTTP on 127.0.0.1:8080) and local builds are in Getting started.

Documentation

The full documentation is at geiserx.github.io/telegram-archive-mcp.

Getting started: npm, Docker Compose, local build
Configuration: environment variables and client configuration
Usage: the 4 resources and 10 tools, paging, reading one day at a time
Development: testing, contributing, credits
Related projects: Telegram Archive, other MCP servers, where this one is listed

License

GPL-3.0-or-later