telegram_list_chats
Telegram · macOS · Windows
Effect: read (strongest supported action). Status: gated.
Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.
macOS
Purpose
Lists your Telegram chats (people, groups, channels) with unread counts and the last message preview, newest first. Returns each chat's `id` to use with telegram_read_messages, telegram_search_messages and telegram_send_message. Requires Telegram connected (telegram_connect); if it isn't, returns how to connect, never an empty list.
Required inputs
No required inputs are declared in this platform's schema. Optional selectors and runtime requirements may still apply.
Permissions and confirmation
No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.
- Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.
Full input schema — macOS
{
"properties": {
"account": {
"description": "Which linked Telegram account to use: its label or id from telegram_list_accounts. Leave it out to use the default account.",
"type": "string"
},
"limit": {
"description": "Max chats (default 50, max 100).",
"type": "integer"
}
},
"required": [],
"type": "object"
}Documentation example
Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.
{
"limit": 5
}Windows
Purpose
Lists your Telegram chats (people, groups, channels) with unread counts and the last message preview, newest first. Returns each chat's `id` to use with telegram_read_messages, telegram_search_messages and telegram_send_message. Requires Telegram connected (telegram_connect); if it isn't, returns how to connect, never an empty list.
Required inputs
No required inputs are declared in this platform's schema. Optional selectors and runtime requirements may still apply.
Permissions and confirmation
No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.
- Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.
Full input schema — Windows
{
"properties": {
"account": {
"description": "Which linked Telegram account to use: its label or id from telegram_list_accounts. Leave it out to use the default account.",
"type": "string"
},
"limit": {
"description": "Max chats (default 50, max 100).",
"type": "integer"
}
},
"required": [],
"type": "object"
}Documentation example
Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.
{
"limit": 5
}