
Agent Telegram
Control Telegram accounts and build bots via Claude using TDLib
What You Can Do
You can authenticate Telegram accounts, list and inspect chats, send messages, and build intelligent Telegram bots that Claude controls. The skill handles all API credential provisioning automatically via TDLib, eliminating manual setup complexity. Claude drives the entire authentication flow and manages stateful Telegram interactions seamlessly.
Features
no manual my.telegram.org setup required
authentication persists locally across commands
list, inspect, and interact with Telegram conversations
send text messages to users, groups, and channels by username or chat ID
switch between multiple authenticated Telegram accounts
Claude handles login without user intervention
minimal user input required to get started
Example Output
Example 1: List Telegram chats
Chats:
- Personal Account (Chat ID: 123456789)
- Development Team (Chat ID: 987654321)
- Notifications Bot (Chat ID: 555666777)
Example 2: Send a message to a contact
Message sent to @john_doe:
"Project update: deployment scheduled for 2pm UTC"
Status: Delivered
Example 3: Authenticate and configure account
Authentication initiated for +821012345678
Provisioning code sent to Telegram app
Account authenticated successfully
Default account set to: Personal Account
What's Included
- SKILL.md: Complete agent-telegram instruction file with authentication flow and command reference
- Quick Start Guide: Copy-paste commands for login, chat listing, and message sending
- Authentication Workflow: Step-by-step agent behavior for handling multi-factor verification and account setup
- CLI Command Reference: Full list of supported commands: auth, chat, message operations
- Multi-Account Management Framework: Guidelines for switching and managing multiple Telegram accounts
Who It's For
- AI/Prompt Engineers — building Telegram bots and automated messaging workflows with Claude
- DevOps & Automation Engineers — integrating Telegram notifications into CI/CD pipelines and monitoring systems
- Customer Support Teams — automating Telegram-based support and notification systems
- Content Creators & Community Managers — managing Telegram channels and automating audience engagement
- AI Application Developers — building conversational agents that interact with Telegram users
Best For
- Building intelligent Telegram bots that Claude controls and operates
- Automating Telegram notifications and alerts from AI workflows
- Extracting and analyzing chat data from Telegram conversations
- Sending bulk messages or scheduled notifications via Telegram
- Creating interactive agents that respond to Telegram messages in real-time







