telegram-list

List accessible Telegram groups, channels, and DMs with JSON output.

5|1|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/lycfyi/community-agent-plugin --skill telegram-list
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: telegram-list
Source: https://github.com/lycfyi/community-agent-plugin/tree/main/plugins/telegram-connector/skills/telegram-list
Command: npx skills add https://github.com/lycfyi/community-agent-plugin --skill telegram-list

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Telegram users often need a quick inventory of what groups, channels, and direct messages are accessible, including forum topics when available, to plan engagement and outreach.

Core Features & Use Cases

  • List all accessible Telegram groups and channels, including DMs by default.
  • Include topic-level visibility for groups with forum topics enabled.
  • Output can be consumed by other tools in JSON or read by humans for quick discovery.

Quick Start

Run the telegram-list tool to enumerate groups, channels, and DMs. Example: python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_list.py Optionally exclude DMs with --no-dms, target a specific group with --group <GROUP_ID>, or output JSON with --json.

Frequently Asked Questions about telegram-list

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

FAQPage Schema
How do I list all my Telegram groups, channels, and direct messages?

You can enumerate accessible Telegram groups, channels, and DMs by running the telegram-list tool with an active Telegram session state. It outputs a complete inventory for quick discovery.

Can I view Telegram forum topics when listing groups?

Yes, listing Telegram groups includes topic-level visibility for any groups that have forum topics enabled. This provides a detailed breakdown of all available forum discussions.

How do I get a JSON output of my Telegram channels and groups inventory?

To get JSON output of your Telegram channels and groups inventory, run the list tool with the --json flag. This formats the data for consumption by other downstream tools.

How can I exclude direct messages when listing my Telegram channels?

You can exclude direct messages when listing Telegram channels by passing the --no-dms flag to the tool. This restricts the output to only show groups and channels.

Is it possible to target a specific Telegram group for inventory listing?

Yes, you can target a specific Telegram group for inventory listing by using the --group <GROUP_ID> flag. This filters the enumeration to only the specified group.

Do I need a Telegram session state to enumerate my channels and DMs?

Yes, a Telegram session state is required to enumerate accessible channels and DMs. The tool relies on this active session to authenticate and retrieve your full conversation inventory.