telegram-sync

Sync Telegram DMs and group chats to local Markdown-friendly storage.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Telegram conversations often need to be archived and analyzed, but manual exports are tedious and error-prone. This skill provides a reliable method to sync messages from Telegram (DMs and groups) to a local, Markdown-friendly store for offline access and analysis.

Core Features & Use Cases

  • DMs and Groups: Sync both direct messages and group chats with configurable defaults.
  • Incremental and Full Sync: Keep local storage up-to-date with new messages or perform a full re-sync when needed.
  • Structured Output: Messages are saved in Markdown-friendly format with per-conversation directories for easy lookup and processing.
  • Use Case: Imagine auditing a community's conversations for compliance or sentiment trends; this tool makes it feasible to export and analyze historical messages.

Quick Start

  • Run a full sync: python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_sync.py
  • Sync groups only (no DMs): python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_sync.py --no-dms
  • Sync a specific group: python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_sync.py --group 1234567890

Frequently Asked Questions about telegram-sync

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

FAQPage Schema
How do I sync Telegram messages to local storage for offline analysis?

You can sync Telegram messages to local storage by running a Python script that fetches direct messages and group chats, saving them in a Markdown-friendly format with per-conversation directories for easy lookup and analysis.

Can I archive only specific Telegram group chats instead of all conversations?

Yes, you can sync specific Telegram group chats by passing the target group ID as an argument to the Python sync tool, restricting the archival process to that single conversation instead of defaulting to all groups and DMs.

Does the Telegram sync tool support incremental updates for new messages?

Yes, the Telegram sync tool supports incremental updates by default, fetching only new messages to keep local storage current, while also providing an option to perform a full re-sync of all historical messages when needed.

What is the best way to export Telegram group chats to Markdown format?

The best way to export Telegram group chats to Markdown format is using this sync tool, which structures output into per-conversation directories, ensuring messages are saved in a Markdown-friendly format for easy downstream processing.

Do I need Python to run the Telegram message archival process?

Yes, you need Python installed to run the Telegram message archival process, as the sync tool relies on Python tooling to execute the script that fetches and saves messages to local storage.