> ## 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 Messages

`outlook_list_messages`

Lists messages in an Outlook mail folder, ordered newest-first. Returns subject, sender, received date, read status, and a short body preview. Use `outlook_get_message` to retrieve the full body of a specific message.

## Parameters

| Parameter         | Type   | Required | Description                                                                                                                              |
| ----------------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `folder_id`       | string | No       | Folder to list. Supports well-known names: `"inbox"`, `"drafts"`, `"sentitems"`, `"deleteditems"`, `"junkemail"`. Defaults to `"inbox"`. |
| `limit`           | number | No       | Max messages to return (1–100, default 20).                                                                                              |
| `offset`          | number | No       | Messages to skip for pagination (default 0).                                                                                             |
| `response_format` | string | No       | Output format: `"markdown"` (default) or `"json"`.                                                                                       |

## Returns

An array of message objects, each with `id`, `subject`, `from`, `toRecipients`, `receivedDateTime`, `isRead`, `bodyPreview`, `importance`, `hasAttachments`, `webLink`, and `conversationId`.

## Example use

> "Show me my last 10 unread emails in the inbox."