telegram-telethon

Automate Telegram messaging, drafts, media handling, and daemon sessions with Telethon and Claude Code.

3|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/pinion05/skills --skill telegram-telethon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: telegram-telethon
Source: https://github.com/pinion05/skills/tree/main/telegram-telethon
Command: npx skills add https://github.com/pinion05/skills --skill telegram-telethon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires telethon, pyyaml, rich, questionary, and includes scripts (resource) components.

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

Frequently Asked Questions about telegram-telethon

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

FAQPage Schema
How do I automate Telegram message sending and receiving using Telethon?

You can automate Telegram message sending, receiving, searching, editing, and deleting by running a Telethon-based wrapper script that requires Python 3+, an API ID, and an API hash to interact with your chats programmatically.

Can I run a background daemon for Telegram that spawns per-chat Claude sessions?

Yes, a daemon mode enables background monitoring of Telegram chats and spawns per-chat Claude sessions with persistent state, allowing automated workflows to survive restarts and resume exactly where they left off.

How do I set up Telethon for automated Telegram workflows with Claude Code?

You set up the Telethon environment interactively via a setup script or non-interactively by providing your Telegram API ID, API hash, and phone number, storing configuration in a local directory for session persistence.

Does the Telegram automation script support downloading media and transcribing voice messages?

Yes, the automation script supports media operations including downloading media files from chats and transcribing voice messages, alongside core message and draft management functionalities within your Telegram workflows.

What is the best way to capture Telegram messages into Obsidian notes automatically?

You can append Telegram messages directly to Obsidian daily notes or person notes for knowledge capture using the integrated workflow, combining automated message retrieval with structured note creation.

Do I need Claude Code tooling to use the Telethon daemon for Telegram automation?

Claude Code tooling is optional but required for the daemon mode to spawn per-chat Claude sessions, while core Telethon messaging, media handling, and draft management rely on Python 3, Telethon, and PyYAML.