Telegram Archive Mcp
by geiserxcommunityv0.0.2
2
Telegram-Archive-MCP is a bridge that exposes any Telegram-Archive instance as an MCP server, allowing LLMs to search messages, browse chats, and access archived Telegram history.
From the registry: MCP server for Telegram Archive — search messages, browse chats, and access history
Install & configure
Prerequisites
- requiredTelegram-Archive instanceA running Telegram-Archive server to connect tohttps://github.com/nicmart-dev/telegram-archive
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `telegram-archive-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Telegram-Archive instance** — A running Telegram-Archive server to connect to (https://github.com/nicmart-dev/telegram-archive)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["telegram-archive-mcp"]
- required environment variables:
- `TELEGRAM_ARCHIVE_URL`: URL of your Telegram-Archive instance (example: `http://localhost:3000`)
- optional environment variables:
- `TELEGRAM_ARCHIVE_USER`: Login username for the archive instance (example: `<your-username>`)
- `TELEGRAM_ARCHIVE_PASS`: Login password for the archive instance (example: `<your-password>`)
Note: Exposes a Telegram-Archive instance as MCP. 7 tools for search, message retrieval, chat stats. Also available via Docker (HTTP transport on port 8080).
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Exposes a Telegram-Archive instance as MCP. 7 tools for search, message retrieval, chat stats. Also available via Docker (HTTP transport on port 8080).
Tools (7)
search_messages
Search and retrieve messages.
get_messages
Retrieve messages from the archive.
get_pinned_messages
Retrieve pinned messages from the archive.
get_messages_by_date
Retrieve messages based on a specific date.
get_chat_stats
Inspect chat statistics.
get_topics
Retrieve topics from the archive.
refresh_stats
Refresh chat statistics.
Environment variables
TELEGRAM_ARCHIVE_URLrequiredTelegram-Archive instance URL (without trailing /).TELEGRAM_ARCHIVE_USERrequiredLogin username for session auth via /api/login.TELEGRAM_ARCHIVE_PASSrequiredLogin password for session auth via /api/login.Packages
telegram-archive-mcp
npmv0.0.2transport: stdio
drumsergio/telegram-archive-mcp:v0.0.2
ocitransport: stdio
Details
- Language
- Go
- License
- GPL-3.0
- Released
- Apr 3, 2026
- Last commit
- May 19, 2026
- Registry name
- io.github.GeiserX/telegram-archive-mcp