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

Chalk Labs

Need help deploying Telegram Archive MCP?

Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.

Book a call

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.

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 (11 days ago)
Last release: Oct 21, 2026 (12 days ago)
Last package publish: Oct 21, 2026 (12 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 Registry github-graphql

More from GeiserX

Done for you

Rather not set it up yourself?

Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.

See how we build AI agents →Read the case studies

Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.

launches shipped: 50+; launches shipped
media placements: 500+; media placements
founders on every account: 2; founders on every account

Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block

Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.

Get Telegram Archive MCP running in your business

Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.

Need help deploying Telegram Archive MCP?

Call Get help

Cite this page

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