Telegram Archive Search — telemcp

    1

    Search and summarize your local Telegram archive with AI: full-text messages, chat timelines, forum topics, and media retrieval through telemcp MCP.

    Free

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    About this skill

    Turn your Telegram history into a searchable local knowledge base. This skill teaches your AI agent to use the open-source telemcp MCP server for precise searches, conversation timelines, forum-topic summaries, and media retrieval without moving your archive to a cloud service.

    What it does

    • Finds old messages with flexible keyword and phrase search, sender/chat filters, and boolean queries.
    • Reconstructs conversations by chat, sender, date range, direction, and forum topic, with surrounding context when needed.
    • Checks freshness before answering and clearly identifies stale, truncated, excluded, or empty results.
    • Retrieves media — photos, documents, voice messages, videos, and more — to a local folder only when requested.
    • Manages sync exclusions explicitly, with a warning before removing locally archived chat data.

    Why telemcp

    telemcp is a single self-contained Go binary with no Python runtime, database server, embedding API, telemetry, or cloud middleman. It archives Telegram chats in local SQLite, supports resident live sync, and exposes chats, messages, topics, full-text search, and media through MCP.

    Private by design

    Your Telegram archive stays on your machine. The skill contains no credentials, session files, executable code, or external integrations. Login happens directly in the local telemcp terminal prompt. Query tools cannot send, delete, or edit Telegram messages.

    Requirements

    A Telegram account, the open-source telemcp binary, and an MCP-capable agent. Go 1.27+ is needed only when installing with go install; a Homebrew package is available for macOS. Installation and MCP configuration instructions are included.

    Limitations

    Results cover only the configured local archive and its synced period. Media retrieval may connect to Telegram for files not already archived. Excluding a chat removes its local archived data immediately; restoring it requires a later sync. Use of a personal Telegram account is subject to Telegram's terms and rate limits.

    Source code and project documentation

    Requires local telemcp MCP server setup. Cannot send messages or modify data on Telegram servers. Search is limited to locally archived data.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Free forever

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 3 days ago

    • Free with an Agensi account

    Requires

    Telegram
    Telegram account
    Telemcp MCP

    Permissions

    Read Files
    Write Files
    Network Access

    Allowed Hosts

    api.telegram.org

    The agent reads the local archive only through telemcp MCP. Write Files applies only to explicitly requested media exports. Network Access is used by telemcp for Telegram sync and missing media downloads. The skill never reads session files or sends message content to third-party endpoints.

    Listed3 days ago

    What's inside

    Frequently Asked Questions

    This skill acts as a bridge between your AI agent and the telemcp server, allowing the agent to perform complex SQLite FTS5 searches and extract files from your local Telegram archives without you having to manually scroll or export data.

    This skill requires an active telemcp server and a local SQLite archive of your Telegram data. It is compatible with any AI agent or platform that supports the Model Context Protocol (MCP).

    No, this skill is designed for local archive analysis and cannot send messages, join groups, or fetch live data that hasn't been synced to your local database yet.

    The skill uses ID-based resolution to distinguish between similarly named chats and forum topics, ensuring the AI pulls data from the exact conversation you intended.

    You receive the MCP-compliant skill definition that enables your AI agent to interface with the telemcp server, including tools for searching, filtering, and media extraction.

    The skill utilizes RFC3339 timestamp formatting and FTS5 boolean logic to provide much higher precision than standard keyword searches, allowing for exact phrase matching and specific date-range filtering.

    New in Research & Analysis

    Free