telegram-list

lycfyi's avatarfrom lycfyi

List Telegram groups and channels. Use when user asks about available groups, channels, or wants to discover what's accessible.

⭐2stars🔀0forks📁View on GitHub🕐Updated Jan 9, 2026
[Communication Tools]

When & Why to Use This Skill

The telegram-list skill enables users to efficiently discover and organize their Telegram workspace by listing all accessible groups, channels, direct messages (DMs), and forum topics. It provides essential metadata, including unique IDs and member counts, making it a foundational tool for users looking to manage high volumes of communication or set up further automation within the Telegram ecosystem.

Use Cases

  • Workspace Audit: Quickly generate a comprehensive list of all joined Telegram groups and channels to clean up or organize your communication feeds.
  • Automation Configuration: Retrieve the specific Group IDs or Topic IDs required as inputs for other automation tools, such as message syncers or data extractors.
  • Forum Navigation: Explore and list individual topics within Telegram supergroups to pinpoint specific discussion threads without manual searching.
  • Contact Management: View an organized list of active Direct Messages (DMs) to keep track of private conversations and user identities.
nametelegram-list
description"List Telegram groups and channels. Use when user asks about available groups, channels, or wants to discover what's accessible."

telegram-list

List Telegram groups, channels, DMs, and forum topics.

Trigger Phrases

  • "list Telegram groups"
  • "what groups do I have on Telegram"
  • "show my Telegram channels"
  • "telegram list"
  • "list topics in [group]"
  • "list my Telegram DMs"

Description

This skill lists all accessible Telegram groups, channels, and DMs. DMs are included by default. For groups with forum topics enabled, you can also list the individual topics.

Usage

List all groups and DMs (default):

python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_list.py

List groups only (exclude DMs):

python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_list.py --no-dms

List topics in a specific group:

python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_list.py --group 1234567890

Output as JSON:

python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_list.py --json

Output Format

Table Output (default)

Found 5 groups/channels:

ID              Type         Members    Topics   Name
----------------------------------------------------------------------
1234567890      supergroup   1500       Yes      My Community
9876543210      channel      5000       -        News Channel
...

Found 3 DMs:

ID              Type         Username             Name
------------------------------------------------------------
111222333       private      @alice               Alice Smith
444555666       private      -                    Bob Jones
...

JSON Output (--json)

[
  {
    "id": 1234567890,
    "name": "My Community",
    "type": "supergroup",
    "username": "mycommunity",
    "member_count": 1500,
    "has_topics": true
  }
]

Group Types

  • private - 1:1 private chats
  • group - Basic groups (< 200 members)
  • supergroup - Upgraded groups (can have topics)
  • channel - Broadcast channels

Forum Topics

Some supergroups have "forum topics" enabled, which is similar to Discord's channel structure. When a group has topics:

  • Messages are organized by topic
  • Use --group GROUP_ID to see available topics
  • Sync will pull messages from each topic separately

Exit Codes

  • 0 - Success
  • 1 - Authentication error
  • 2 - Group not found or configuration error
  • telegram-init - Initialize Telegram connection
  • telegram-sync - Sync messages from groups
  • telegram-read - Read synced messages