ListMessages

Retrieve messages from a Telegram dialog, chat, or channel, ordered newest to oldest. Filter unread messages or limit results to the latest entries for focused message management.

Instructions

List messages in a given dialog, chat or channel. The messages are listed in order from newest to oldest.

If `unread` is set to `True`, only unread messages will be listed. Once a message is read, it will not be
listed again.

If `limit` is set, only the last `limit` messages will be listed. If `unread` is set, the limit will be
the minimum between the unread messages and the limit.

Input Schema

Name	Required	Description	Default
`dialog_id`	Yes
`limit`	No
`unread`	No

Input Schema (JSON Schema)

{
  "description": "List messages in a given dialog, chat or channel. The messages are listed in order from newest to oldest.\n\nIf `unread` is set to `True`, only unread messages will be listed. Once a message is read, it will not be\nlisted again.\n\nIf `limit` is set, only the last `limit` messages will be listed. If `unread` is set, the limit will be\nthe minimum between the unread messages and the limit.",
  "properties": {
    "dialog_id": {
      "title": "Dialog Id",
      "type": "integer"
    },
    "limit": {
      "default": 100,
      "title": "Limit",
      "type": "integer"
    },
    "unread": {
      "default": false,
      "title": "Unread",
      "type": "boolean"
    }
  },
  "required": [
    "dialog_id"
  ],
  "title": "ListMessages",
  "type": "object"
}

Telegram MCP Server

ListMessages

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Telegram MCP Server

Related Tools