telegram-archive-mcp
MCP server to search messages, browse chats and read archived Telegram history.
Tested on Linux
Use it
Linux x86_64
You need first
- Needs the network
- Keys or accounts: TELEGRAM_ARCHIVE_USER, TELEGRAM_ARCHIVE_PASS
Install telegram-archive-mcp globally via npm
npm install -g telegram-archive-mcp
Check that it works
telegram-archive-mcp --helpThe output should contain “Telegram-Archive MCP Bridge 0.4.1”.
Add it to your agent
claude mcp add telegram-archive-mcp -e TELEGRAM_ARCHIVE_URL='<TELEGRAM_ARCHIVE_URL>' -e TELEGRAM_ARCHIVE_USER='<TELEGRAM_ARCHIVE_USER>' -e TELEGRAM_ARCHIVE_PASS='<TELEGRAM_ARCHIVE_PASS>' -- telegram-archive-mcpJSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"telegram-archive-mcp": {
"command": "telegram-archive-mcp",
"args": [],
"env": {
"TELEGRAM_ARCHIVE_URL": "<TELEGRAM_ARCHIVE_URL>",
"TELEGRAM_ARCHIVE_USER": "<TELEGRAM_ARCHIVE_USER>",
"TELEGRAM_ARCHIVE_PASS": "<TELEGRAM_ARCHIVE_PASS>"
}
}
}
}You fill in
TELEGRAM_ARCHIVE_URL: URL of Telegram-Archive viewer (required)TELEGRAM_ARCHIVE_USER: viewer username (required)TELEGRAM_ARCHIVE_PASS: viewer password (required)
Ask the user for TELEGRAM_ARCHIVE_URL, TELEGRAM_ARCHIVE_USER, TELEGRAM_ARCHIVE_PASS; pickfit never had a value, so these are placeholders.
Add telegram-archive-mcp as a server in your MCP client, then use its tools such as list_chats and search_all_chats from the client.
What it does
- Search messages across chatsNot tested
- Browse chats page by pageNot tested
- Read archived Telegram historyNot tested
- View photos attached to messagesNot tested
How far pickfit got
Linux x86_64
- Installs
- Connects
- 0 of 4 features work
- Works offline
Good for
- Search message text across every archived chat at once
- List and filter archived chats
- Read context around a specific archived message
- Read all messages from one calendar day
- View photo attached to an archived message
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client connects and lists its tools
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version 0.4.1
An MCP client handshake over stdio listed 12 tools.