telegram_watch_messages

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

Asks Local MCP to tell this session when new messages arrive in chosen Telegram chats, so you do not have to keep calling telegram_read_messages. set needs `account` and `chats`. Local MCP checks every 300 seconds (delivery "poll"), so a notice can come about 5 minutes after the message. Each notice is a notifications/claude/channel message to this session with platform, account, chat, count, max_id and event_id, never the text: read the chat with telegram_read_messages. A notice can repeat: ignore an event_id you already saw. Watching starts now; read the chats once to catch up. It ends with this session. Only AI client builds certified to show these notices can set it; any other gets delivery "unsupported" and nothing is set up.

Required inputs

action — set: watch these chats for this session; clear: stop; status: what is watched and when it was last checked.

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"
    },
    "action": {
      "description": "set: watch these chats for this session; clear: stop; status: what is watched and when it was last checked.",
      "enum": [
        "set",
        "clear",
        "status"
      ],
      "type": "string"
    },
    "chats": {
      "description": "For set: 1 to 20 chat ids from telegram_list_chats of that account (user:… or, with include_groups, chat:…).",
      "items": {
        "type": "string"
      },
      "maxItems": 20,
      "minItems": 1,
      "type": "array"
    },
    "include_groups": {
      "description": "Allow basic groups (chat:…). Channels are not supported.",
      "type": "boolean"
    }
  },
  "required": [
    "action"
  ],
  "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.

{
  "account": "Demo Telegram",
  "action": "set",
  "chats": [
    "user:5550100123"
  ]
}

Windows