---
title: "telegram"
description: "Personal Telegram account tools: summarize, search, send, and manage chats over MCP, with a local message cache for repeat search and aggregates."
canonical: https://agentpluginsdirectory.com/plugins/telegram
last-updated: 2026-10-13
---

# telegram
Personal Telegram account tools: summarize, search, send, and manage chats over MCP, with a local message cache for repeat search and aggregates.
- Slug: telegram
- Publisher: Brian Chew
- Repository: https://github.com/bchewy/telegram-agent-plugin
- Manifest: telegram/plugin.json
- Version: 0.1.0
- License: MIT
- Category (editorial): integrations
- Skills: 8 (telegram-aggregate, telegram-login, telegram-manage-groups, telegram-media-inspect, telegram-search, telegram-send, telegram-summarize, telegram-triage-unread)
- MCP servers: 1 (telegram_personal)
- Stars: 38
- Repository created: 2026-04-18
- Repository last pushed: 2026-08-22
- Publisher type: User
- Listing: https://agentpluginsdirectory.com/plugins/telegram
- Schema: https://agent-plugins.org/schemas/1.0.0/plugin.schema.json

## What telegram does, in the publisher's words

Use your personal Telegram account from your coding agent. The same bundle works in three kinds of clients:

- Codex: installed as a plugin from a local marketplace
- Grok Bot / Cursor (custom MCP): registered as a plain local stdio MCP server
- Any Agent Plugins 1.0.0 client: loaded from the portable plugin.json + mcp.json

This plugin lets your agent:

- summarize chats
- search recent messages live, or search cached chat history for repeat/broad/old lookups
- sync recent chat history into a local cache once, then summarize, search, and aggregate locally to reduce repeated Telegram API calls (see the cache section below: first sync covers the newest N messages; older backfill is not yet exposed)

If you just want the shortest path:

From the project README, punctuation lightly normalized. Full text: https://raw.githubusercontent.com/bchewy/telegram-agent-plugin/HEAD/README.md

## Skills

- telegram-aggregate: Use when cached Telegram volume or sender stats are requested.
- telegram-login: Use when Telegram auth setup, reset, or diagnostics are requested.
- telegram-manage-groups: Use when Telegram groups, channels, members, or admins are requested.
- telegram-media-inspect: Use when the user asks to inspect, watch, listen to, transcribe, or understand Telegram voice notes, video notes, audio files, videos, or other message media.
- telegram-search: Use when finding Telegram messages by query or window.
- telegram-send: Use when drafting, sending, replying, forwarding, or scheduling Telegram.
- telegram-summarize: Use when Telegram summaries, unread catch-ups, or recaps are requested.
- telegram-triage-unread: Use when priority-ranked unread Telegram digests are requested.

Descriptions come from the frontmatter of each SKILL.md, punctuation lightly normalized.

## MCP servers

- telegram_personal: transport: stdio; command: uv run --project ${PLUGIN_ROOT}/mcp_server codex-telegram serve; env: UV_PROJECT_ENVIRONMENT

Read from the plugin's own mcp.json. Environment variable names only, never values.