telegram

What problem does it solve?

Fetch, search, download, and send Telegram messages with flexible filtering and output options. It enables users to manage Telegram conversations directly from Claude Code and integrate results into notes, reports, or daily workflows.

Core Features & Use Cases

• List chats: display available chats with unread counts.
• Fetch recent messages: retrieve messages from specific chats or across chats.
• Search messages: perform content search across chats.
• Send messages/files: send text or attachments to chats or users.
• Download attachments: fetch media from chats to a local folder.
• Output options: output as Markdown or JSON; optionally append to daily or person notes.

Quick Start

Example commands to get started:

• List chats: python3 scripts/telegram_fetch.py list
• Fetch recent messages: python3/scripts/telegram_fetch.py recent --limit 20 --chat "Tool Building Ape"
• Search messages: python3/scripts/telegram_fetch.py search "project update" --limit 20 --chat-id 123456789
• Send a message: python3/scripts/telegram_fetch.py send --chat "John Doe" --text "Hello!"