Skip to content

feat(groups): add 'groups members list' command + groupsMembersList MCP tool#56

Open
Tolsi wants to merge 1 commit into
kfastov:mainfrom
Tolsi:feat/group-members-list
Open

feat(groups): add 'groups members list' command + groupsMembersList MCP tool#56
Tolsi wants to merge 1 commit into
kfastov:mainfrom
Tolsi:feat/group-members-list

Conversation

@Tolsi

@Tolsi Tolsi commented Jun 17, 2026

Copy link
Copy Markdown

What

Adds the ability to list group/supergroup members. Previously groups members only supported add / remove — there was no way to enumerate participants.

Changes

  • CLI: tgcli groups members list --chat <id> [--limit <n>] [--search <text>]
  • MCP tool: groupsMembersList (params: channelId, optional limit, optional search)
  • core op groupMembersListtelegramClient.getGroupMembers() using mtcute iterChatMembers
  • --search filters client-side by name/username, so it works reliably regardless of backend participant-search behaviour
  • Docs updated: docs/cli.md, docs/mcp-tools.md, SKILL.md

Output per member: { userId, username, name, isBot, status }.

Text mode prints name<TAB>@username<TAB>userId<TAB>(status[, bot]); --json returns the array.

Testing

  • Existing suite: 339 tests pass (npm test, 27 files)
  • Manually verified against a real supergroup: full list, --json, --limit, and --search (correctly narrows to matches)

🤖 Generated with Claude Code

Adds the ability to list group/supergroup members — previously only
add/remove were available.

- CLI: `groups members list --chat <id> [--limit <n>] [--search <text>]`
- MCP tool: `groupsMembersList`
- core op `groupMembersList` + `telegramClient.getGroupMembers()`
  (mtcute iterChatMembers); `--search` filters client-side by
  name/username so it works regardless of backend participant search.

Output per member: userId, username, name, isBot, status.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant