List Teams Chats
list_chatsLists your Microsoft Teams one-to-one, group, and meeting chats with topic or member names, last-message time and sender, sorted by last-message time descending.
Instructions
List your Teams chats (1:1, group, and meeting chats), most recent message first. Each line names the chat by its topic or its members and shows when the last message was sent and by whom. Note: the self-chat (notes to self) is not listed here — use chat_id '48:notes' to send to it directly.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_chats"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | Number of chats to return (default: 25, max 50; with since, every match unless set). Graph may return fewer per page when member names are included; use fetch_all_pages for more. | |
| since | No | Only chats whose last message is after this ISO 8601 time with a time zone, e.g. 2026-10-01T00:00:00Z. Reads pages until it reaches an older chat (at most 20 pages) and returns every match unless top is set. Chats with no messages are skipped. | |
| fetch_all_pages | No | Fetch all pages of results (max 50 pages) |