telegram-telethon

Community

Automate Telegram workflows with Telethon and Claude Code.

Authorpinion05
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This skill eliminates tedious manual Telegram administration by providing a robust Telethon-based wrapper with Claude Code integration. It enables automated messaging, media handling, drafts, and a daemon-driven flow that can spawn per-chat Claude sessions and persist state across restarts, reducing repetitive tasks and improving consistency.

Core Features & Use Cases

  • Message Operations: Send, receive, search, edit, and delete messages
  • Draft Management: Create, update, list, and send drafts
  • Media Operations: Download media, transcribe voice messages
  • Daemon Mode: Background monitoring with per-chat Claude sessions and queued handling
  • Session Persistence: Claude sessions survive restarts and resume per chat
  • Obsidian Integration: Append messages to daily notes or person notes for knowledge capture

Quick Start

  • Interactive setup: python3 scripts/tg.py setup
  • Non-interactive setup: python3 scripts/tg.py setup --api-id YOUR_API_ID --api-hash YOUR_API_HASH --phone +YOUR_PHONE
  • Check connection status: python3 scripts/tg.py status
  • List chats: python3 scripts/tg.py list
  • Start daemon (foreground): python3 scripts/tgd.py start --foreground

Dependency Matrix

Required Modules

telethonpyyamlrichquestionary

Components

scripts

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: telegram-telethon
Download link: https://github.com/pinion05/skills/archive/main.zip#telegram-telethon

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.