> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.deepmask.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Folders

`outlook_list_folders`

Lists all mail folders in the user's mailbox. Returns folder IDs, display names, and item counts. Use the returned `id` as the `folder_id` in `outlook_list_messages`.

You can also skip this action and pass well-known folder names directly to mail actions: `inbox`, `drafts`, `sentitems`, `deleteditems`, `junkemail`.

## Parameters

| Parameter         | Type   | Required | Description                                        |
| ----------------- | ------ | -------- | -------------------------------------------------- |
| `response_format` | string | No       | Output format: `"markdown"` (default) or `"json"`. |

## Returns

An array of folder objects, each with `id`, `displayName`, `totalItemCount`, `unreadItemCount`, `isHidden`, and `parentFolderId`.

## Example use

> "What mail folders do I have in my mailbox?"