graph_list_mail_folders
List mail folders with unread and total counts, then use the returned folder IDs to read or move messages.
Instructions
List mail folders, including their unread and total counts.
Use the returned folder IDs with graph_list_mail or graph_move_mail.
Args: parent_folder_id: Parent folder ID. Empty lists top-level folders. top: Maximum number of folders to return (default 25). skip: Number of items to skip before returning results (default 0). Graph returns at most 50 per call, so page by raising skip in steps of top. next_link: Opaque nextLink URL from a previous call, used to fetch the next page. Overrides the other paging arguments when supplied. include_next_link: Whether to wrap the result as {items, next_link} so paging can continue (default false, which returns a bare list). mailbox: Shared mailbox address or user ID to act on. Empty targets your own mailbox. Requires the delegated Mail.*.Shared permissions.
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": "graph_list_mail_folders"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | ||
| skip | No | ||
| mailbox | No | ||
| next_link | No | ||
| parent_folder_id | No | ||
| include_next_link | No |