Read Teams Chat Messages
list_chat_messagesRetrieve messages from a Microsoft Teams chat, newest first, with sender, timestamp, flags, and filters for time and count. Use it to review recent activity or catch edits.
Instructions
List messages in a Teams chat, newest first. Each message is a line '- () [You] [App] [Urgent|High importance] [Mentions you] (ID: )' (flags only when they apply), followed by its text on a ' > ' line. System events (joins, renames) and deleted messages are left out.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"chat_id": "<chat_id>"
},
"name": "list_chat_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | Number of messages (default: 25, max 50) | |
| since | No | Only messages created or changed after this ISO 8601 time with a time zone, e.g. 2026-10-01T00:00:00Z. An old message edited after it is included; its line still shows when it was created. Returns at most top messages (default 25); if more match, the output ends with 'Note: more messages match; raise top or move since later to see them.' | |
| chat_id | Yes | Chat ID | |
| max_chars | No | Cut each message's text at this length (default: 300) | |
| fetch_all_pages | No | Fetch all pages of results (max 50 pages) |