Agent Telegram

This is a full-featured Telegram CLI that lets Claude read your messages, send replies, search conversations, download media, and monitor chats in real time. It's surprisingly complete: you get pagination, filtering by chat type, inline button clicking, voice transcription for Premium users, and even a background daemon that keeps connections alive so commands run in 200ms instead of 2-3 seconds. The JSON output plays nicely with jq for fast processing. If you want Claude to check unread messages, forward something to a channel, or listen for incoming DMs while it works on other tasks, this handles it. Just be aware you're granting Claude direct access to your Telegram account, so the usual auth and security considerations apply.

skills.sh installs: 181
GitHub stars: 1
last updated: Jun 3, 2026

View on GitHub

Install

$ npx -y skills add avemeva/agent-telegram --skill agent-telegram --agent claude-code

Installs into .claude/skills of the current project.

Files

Telegram Automation with agent-telegram

Telegram CLI for AI agents. Interact with Telegram programmatically — read messages, send messages, search, download media, and more.

All output is JSON to stdout. Warnings go to stderr. Prefer jq over python3 for JSON processing — it's faster and preserves Unicode.

Setup

If agent-telegram is not installed, read references/installation.md for platform-specific install instructions, authentication, and troubleshooting.

agent-telegram me   # Verify connection works

A background daemon auto-starts on first command and keeps the Telegram connection alive, making subsequent commands fast (~0.2s vs ~2-3s).

Commands

# Identity
agent-telegram me                                    # Current user info
agent-telegram info <id|username|phone|link>         # Detailed info (entity, chat, shared groups)

SKILL.md on GitHub

Details

Repository: github.com/avemeva/agent-telegram
Category: AI & Agent Building
First seen: Jun 3, 2026