Telegram Archive MCP

Name: Telegram Archive MCP
Author: GeiserX

GeiserXOfficial

Searches and browses Telegram history stored in Telegram Archive: list chats, retrieve messages and run full-text search.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add telegram-archive --env TELEGRAM_ARCHIVE_URL='<TELEGRAM_ARCHIVE_URL>' --env TELEGRAM_ARCHIVE_PASS='<TELEGRAM_ARCHIVE_PASS>' -- npx -y telegram-archive-mcp

~/.codex/config.toml

[mcp_servers.telegram-archive]
command = "npx"
args = ["-y", "telegram-archive-mcp"]
env = { TELEGRAM_ARCHIVE_URL = "<TELEGRAM_ARCHIVE_URL>", TELEGRAM_ARCHIVE_PASS = "<TELEGRAM_ARCHIVE_PASS>" }

# codex mcp add telegram-archive --env TELEGRAM_ARCHIVE_URL='<TELEGRAM_ARCHIVE_URL>' --env TELEGRAM_ARCHIVE_PASS='<TELEGRAM_ARCHIVE_PASS>' -- npx -y telegram-archive-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "telegram-archive": {
      "command": "npx",
      "args": [
        "-y",
        "telegram-archive-mcp"
      ],
      "env": {
        "TELEGRAM_ARCHIVE_URL": "<TELEGRAM_ARCHIVE_URL>",
        "TELEGRAM_ARCHIVE_PASS": "<TELEGRAM_ARCHIVE_PASS>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "telegram-archive": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "telegram-archive-mcp"
      ],
      "env": {
        "TELEGRAM_ARCHIVE_URL": "<TELEGRAM_ARCHIVE_URL>",
        "TELEGRAM_ARCHIVE_PASS": "<TELEGRAM_ARCHIVE_PASS>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "telegram-archive": {
      "command": "npx",
      "args": [
        "-y",
        "telegram-archive-mcp"
      ],
      "env": {
        "TELEGRAM_ARCHIVE_URL": "<TELEGRAM_ARCHIVE_URL>",
        "TELEGRAM_ARCHIVE_PASS": "<TELEGRAM_ARCHIVE_PASS>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "telegram-archive": {
      "command": "npx",
      "args": [
        "-y",
        "telegram-archive-mcp"
      ],
      "env": {
        "TELEGRAM_ARCHIVE_URL": "<TELEGRAM_ARCHIVE_URL>",
        "TELEGRAM_ARCHIVE_PASS": "<TELEGRAM_ARCHIVE_PASS>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "telegram-archive": {
      "command": "npx",
      "args": [
        "-y",
        "telegram-archive-mcp"
      ],
      "env": {
        "TELEGRAM_ARCHIVE_URL": "<TELEGRAM_ARCHIVE_URL>",
        "TELEGRAM_ARCHIVE_PASS": "<TELEGRAM_ARCHIVE_PASS>"
      }
    }
  }
}

Environment variables

TELEGRAM_ARCHIVE_URL
TELEGRAM_ARCHIVE_PASS

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related