Skip to content
Agentmart
Submit a tool

Telegram Archive MCP

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

Connector by GeiserX · GitHub account verified by the MCP Registry

IndexedGPL-3.0Local (stdio)★ 7
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/geiserx-telegram-archive-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Runs code on install

Its package runs an install script (such as npm postinstall or setup.py code) as soon as you install it, before any tool is called. Read the script first.

Tools
10 read · 0 write · 0 deleteRead-only
Secrets
1 (API keys, tokens or passwords)
Install scripts
Runs code on install
Runs as
Node.js package

Tools by what they do 10

Read from the source code; the running server may list different tools.

Read 10 · Look things up without changing anything.

  • get_chat_stats
  • get_media
  • get_messages
  • get_messages_by_date
  • get_pinned_messages
  • get_topics
  • list_chats
  • list_folders
  • refresh_stats
  • search_messages

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • TELEGRAM_ARCHIVE_PASS

Other settings (environment variables or headers).

  • TELEGRAM_ARCHIVE_URL
  • TELEGRAM_ARCHIVE_USER

Network hosts it talks to 4

  • geiserx.github.io · found in code
  • github.com · found in code
  • glama.ai · found in code
  • hub.docker.com · found in code

Tools (10)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • get_chat_stats

    Get statistics for a specific Telegram chat

  • get_media

    Get the photo or file attached to one message. A JPEG, PNG, WebP or GIF image comes back as an image you can look at, scaled to at most 1568 pixels on its longest side, after a JSON text block with the message's message_id, date, sender, text (the caption) and reply_to_msg_id, and the file's media_key, kind, file_name, mime_type, size_bytes, image_returned, width, height and scaled. Any other file returns only that JSON text block, with a note saying why the file is not included.

  • get_messages

    Get messages from a Telegram chat, newest first. Page with offset, or with the keyset cursor: pass the date and id of the last message you received as before_date and before_id to get the older ones (constant time on huge chats). after_id returns messages newer than an id. Dates are naive UTC.

  • get_messages_by_date

    Get every message of a Telegram chat sent on one calendar day, oldest first. The day is taken in the given timezone (default UTC); the archive stores dates in UTC. Walks the chat with the keyset cursor, so it is cheap even on chats with hundreds of thousands of messages.

  • get_pinned_messages

    Get pinned messages from a Telegram chat

  • get_topics

    Get topics (forum threads) from a Telegram chat

  • list_chats

    List archived Telegram chats, most recent first. Use this first: each chat's ref is the chat_id the other tools take. Each row also carries id (the numeric Telegram chat id), type, accounts (the archive account ids holding the chat), and its title or name. The answer is {chats, total, limit, offset, has_more}; page with offset while has_more is true.

  • list_folders

    List all Telegram chat folders

  • refresh_stats

    Force recalculation of global telegram-archive statistics

  • search_messages

    Search messages in a Telegram chat by keyword

Signals

Stars
7
Forks
0
Open issues
0
Last commit
Oct 22, 2026 (7 days ago)
Last release
Oct 21, 2026 (8 days ago)
Last package publish
Oct 21, 2026 (8 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.GeiserX/telegram-archive-mcp
Version
0.3.1
Auth
API key
Packages
npm telegram-archive-mcpoci drumsergio/telegram-archive-mcp:v0.3.1
License
GPL-3.0
Repository
github.com/GeiserX/telegram-archive-mcp
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql

More from GeiserX

Cite this page

Telegram Archive MCP. Agent Mart. https://agentmart.dev/connectors/geiserx-telegram-archive-mcp (last updated 2026-10-24)