telegram-read

Reads and searches Telegram messages from local syncs with SQLite-like precision.

5|1|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/lycfyi/community-agent-plugin --skill telegram-read
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: telegram-read
Source: https://github.com/lycfyi/community-agent-plugin/tree/main/plugins/telegram-connector/skills/telegram-read
Command: npx skills add https://github.com/lycfyi/community-agent-plugin --skill telegram-read

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you read and search Telegram conversations that are synced locally, eliminating the need to manually scroll through chat histories and extract relevant messages.

Core Features & Use Cases

  • Read recent messages from a synced Telegram group or chat, making it easy to review discussions without opening the app.
  • Search messages by keyword, phrase, or topic across your stored Telegram history.
  • Filter results by date or by group so you can narrow down conversations quickly during audits or reviews.

Quick Start

Use the telegram_read tool to access locally synced messages: Read all messages from the default group: python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_read.py

Read from a specific group: python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_read.py --group 1234567890

Show last N messages: python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_read.py --last 20

Search for keyword: python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_read.py --search "meeting"

Filter by date: python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_read.py --date 2026-01-06

Output as JSON: python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_read.py --json

Frequently Asked Questions about telegram-read

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search synced Telegram messages by keyword locally?

To search synced Telegram messages, use the --search option with a keyword like "meeting" to query local data and retrieve relevant conversations without opening the app.

Can I filter Telegram chat history by date and group?

Yes, you can filter Telegram chat history by applying the --group and --date options to narrow down conversations quickly during audits or data reviews.

How do I read the last 20 messages from a specific Telegram group?

Read the last 20 messages from a specific Telegram group by running the script with --group and --last 20 options to fetch local conversation history instantly.

Does this approach require an active internet connection to read Telegram conversations?

No, reading Telegram conversations relies entirely on querying locally synced data, eliminating the need for an active connection or manually scrolling through chat histories.

How do I export Telegram messages as JSON for data analysis?

Export Telegram messages as JSON by applying the --json option to the script, which structures the queried local conversation data for programmatic analysis.

What are the limitations when searching locally stored Telegram data?

Searching locally stored Telegram data is limited to messages already synced to your machine, meaning any conversations not present in the local data cannot be queried.