MCP.so
Sign In
T

Telegram Archive Mcp

@GeiserX

About Telegram Archive Mcp

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "telegram-archive": {
      "command": "npx",
      "args": [
        "-y",
        "telegram-archive-mcp"
      ],
      "env": {
        "TELEGRAM_ARCHIVE_URL": "http://localhost:3000",
        "TELEGRAM_ARCHIVE_USER": "",
        "TELEGRAM_ARCHIVE_PASS": ""
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Telegram Archive Mcp?

Telegram Archive Mcp is a bridge that exposes any Telegram-Archive instance as an MCP server, enabling LLMs to search messages, browse chats, and access archived Telegram history. It is designed for developers and AI agents who need programmatic access to archived Telegram data.

How to use Telegram Archive Mcp?

Deploy via Docker Compose or install with npx telegram-archive-mcp (or global npm install). Configure the Telegram-Archive instance URL and optional credentials via environment variables (TELEGRAM_ARCHIVE_URL, TELEGRAM_ARCHIVE_USER, TELEGRAM_ARCHIVE_PASS). The server runs an HTTP JSON-RPC endpoint on port 8080 (or stdio transport). Clients call initialize, then use readResource and callTool to interact.

Key features of Telegram Archive Mcp

  • Exposes archive stats, chats, and folders as read-only resources
  • Provides search, retrieve, and statistics tools for messages
  • Single JSON-RPC endpoint at /mcp
  • Supports both HTTP and stdio transports
  • Easy configuration via environment variables
  • Available as Docker image and npm package

Use cases of Telegram Archive Mcp

  • Search archived Telegram messages using natural language from an LLM
  • Browse chat statistics and folder structures programmatically
  • Retrieve pinned messages or messages filtered by date
  • Integrate telegram archive search into AI agent workflows

FAQ from Telegram Archive Mcp

What does Telegram Archive Mcp need to run?

It requires a running Telegram-Archive instance and optionally its login credentials. The server itself can be run via Docker or Go binary (Go 1.24+).

How do I configure authentication?

Set TELEGRAM_ARCHIVE_USER and TELEGRAM_ARCHIVE_PASS environment variables for session-based authentication with the Telegram-Archive instance. Authentication is optional if the archive does not require it.

What transport options are available?

The default transport is HTTP (listening on 127.0.0.1:8080). Set the TRANSPORT environment variable to stdio to use stdio transport instead.

What resources and tools does it provide?

Resources: telegram-archive://stats, telegram-archive://chats, telegram-archive://folders, telegram-archive://health. Tools: search_messages, get_messages, get_pinned_messages, get_messages_by_date, get_chat_stats, get_topics, refresh_stats.

Where does the message data live?

All message data resides in the connected Telegram-Archive instance; this server does not store any data itself.

Comments

More Communication MCP servers