overpod/mcp-telegram

New Features — Group Management

Full suite of group management tools for creating, configuring, and administering Telegram groups programmatically.

New Tools

telegram-invite-to-group

Invite users to a group or channel.

• chatId — chat ID or username
• users — array of usernames or IDs to invite
• Reports which users were successfully invited and which failed

telegram-kick-user

Remove a user from a group without permanent ban — they can rejoin via invite link.

• chatId — chat ID or username
• userId — user ID or username to kick

telegram-ban-user / telegram-unban-user

Permanently ban or unban a user in a supergroup or channel.

• chatId — chat ID or username
• userId — user ID or username
• Note: only works for supergroups and channels (not basic groups)

telegram-edit-group

Change group title, description, or photo (avatar image).

• chatId — chat ID or username
• title — new group title (optional)
• description — new group description (optional, supergroups only)
• photoPath — absolute path to an image file to set as group photo (optional)

All three parameters are optional and can be combined — e.g. change title and photo in one call.

telegram-leave-group

Leave a group or channel. Works for both basic groups and supergroups/channels.

• chatId — chat ID or username

telegram-set-admin

Promote a user to admin with full permissions (change info, post, edit, delete, ban, invite, pin, manage calls).

• chatId — chat ID or username
• userId — user ID or username to promote
• title — custom admin title (optional, e.g. "Moderator")
• Note: only works for supergroups and channels

telegram-remove-admin

Demote an admin back to regular member.

• chatId — chat ID or username
• userId — user ID or username to demote
• Note: only works for supergroups and channels

Limitations

• ban-user, unban-user, set-admin, remove-admin — supergroups and channels only (not basic groups)
• edit-group description — supergroups only (basic groups don't have descriptions in Telegram API)
• You must have appropriate admin permissions in the target group to use these tools

Use Cases

• AI agent platforms: Create team channels and manage membership automatically
• Automated workspace setup: Create groups, set photos, invite members, assign admins
• Community management: Moderate users with kick/ban, manage admin roster

Combined with v1.15.0

Together with telegram-create-group (v1.15.0), you now have complete group lifecycle management — from creation to administration to departure.

Full Changelog: https://github.com/overpod/mcp-telegram/compare/v1.15.0...v1.16.0