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

# Microsoft Outlook

> Read, send, schedule, and manage Outlook mail and calendars

## At a glance

* **Availability**: Enabled by default.
* **Auth**: OAuth 2.0.
* **Connection**: A user authorizes the connection in the provider's consent screen.
* **Scopes**: `Mail.Read`, `Mail.Send`, `Mail.ReadWrite`, `Calendars.Read`, `Calendars.ReadWrite`, `Group.Read.All`, `Group-Conversation.Read.All`, `offline_access`.

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.

| Variable                  | Required | Description                                                                                                                               |
| ------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `MICROSOFT_CLIENT_ID`     | Yes      | Microsoft Azure App Client ID (Application ID) [Docs](https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade). |
| `MICROSOFT_CLIENT_SECRET` | Yes      | Microsoft Azure App Client Secret [Docs](https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade).              |

## Tools

| Tool                         | Access | Description                                                                                      |
| ---------------------------- | ------ | ------------------------------------------------------------------------------------------------ |
| List Emails                  | Read   | List recent emails from inbox or a specific folder                                               |
| Get Email                    | Read   | Get detailed information about a specific email                                                  |
| Send Email                   | Write  | Send a new email message                                                                         |
| Search Emails                | Read   | Search emails by query, subject, sender, or date                                                 |
| List Folders                 | Read   | List all mail folders in the mailbox                                                             |
| Get Folder                   | Read   | Get metadata for a mail folder                                                                   |
| Create Folder                | Write  | Create a mail folder                                                                             |
| Update Folder                | Write  | Rename a mail folder                                                                             |
| Delete Folder                | Write  | Delete a mail folder                                                                             |
| Mark Email Read              | Write  | Mark an email as read                                                                            |
| Mark Email Unread            | Write  | Mark an email as unread                                                                          |
| Delete Email                 | Write  | Delete an email message                                                                          |
| Move Email                   | Write  | Move an email to another folder                                                                  |
| Archive Email                | Write  | Move an email to the archive folder                                                              |
| Flag Email                   | Write  | Set a follow-up flag on an email                                                                 |
| Clear Email Flag             | Write  | Clear the follow-up flag on an email                                                             |
| Categorize Email             | Write  | Replace the categories on an email                                                               |
| List Categories              | Read   | List Outlook master categories                                                                   |
| Create Category              | Write  | Create an Outlook master category                                                                |
| Update Category              | Write  | Update an Outlook master category color                                                          |
| Delete Category              | Write  | Delete an Outlook master category                                                                |
| Create Draft                 | Write  | Create a draft email message                                                                     |
| List Drafts                  | Read   | List draft email messages                                                                        |
| Get Draft                    | Read   | Get a draft message                                                                              |
| Update Draft                 | Write  | Update a draft email message                                                                     |
| Send Draft                   | Write  | Send a draft email message                                                                       |
| Delete Draft                 | Write  | Delete a draft email message                                                                     |
| Reply Email                  | Write  | Reply to an email                                                                                |
| Reply All Email              | Write  | Reply all to an email                                                                            |
| Forward Email                | Write  | Forward an email                                                                                 |
| Create Reply Draft           | Write  | Create a reply draft for an email                                                                |
| Create Reply All Draft       | Write  | Create a reply-all draft for an email                                                            |
| Create Forward Draft         | Write  | Create a forward draft for an email                                                              |
| List Attachments             | Read   | List attachments for an email message                                                            |
| Get Attachment               | Read   | Get metadata and content for an email attachment                                                 |
| Add Attachment To Message    | Write  | Add a small attachment to a draft message                                                        |
| List Conversation Messages   | Read   | List messages in an Outlook conversation                                                         |
| List Shared Mailbox Emails   | Read   | List messages from a shared or delegated mailbox that the signed-in Microsoft account can access |
| Search Shared Mailbox Emails | Read   | Search messages in a shared or delegated mailbox that the signed-in Microsoft account can access |
| Find Group By Mail           | Read   | Find a Microsoft 365 group by primary email address before reading its group inbox threads       |
| List Group Threads           | Read   | List Microsoft 365 group inbox conversation threads                                              |
| List Group Thread Posts      | Read   | List posts from a Microsoft 365 group inbox conversation thread                                  |
| List Calendars               | Read   | List Outlook calendars                                                                           |
| Get Calendar                 | Read   | Get metadata for an Outlook calendar                                                             |
| Create Calendar              | Write  | Create an Outlook calendar                                                                       |
| Update Calendar              | Write  | Update an Outlook calendar                                                                       |
| Delete Calendar              | Write  | Delete an Outlook calendar                                                                       |
| List Events                  | Read   | List events from a specific Outlook calendar                                                     |
| List Calendar View           | Read   | List occurrences in a calendar time window                                                       |
| Get Event                    | Read   | Get details for an Outlook event                                                                 |
| Create Event                 | Write  | Create an Outlook calendar event                                                                 |
| Update Event                 | Write  | Update an Outlook calendar event                                                                 |
| Delete Event                 | Write  | Delete an Outlook calendar event                                                                 |
| Respond To Event             | Write  | Accept, tentatively accept, or decline an event invitation                                       |
| Get Event Instances          | Read   | List instances of a recurring event in a time window                                             |
| List Event Attachments       | Read   | List attachments for an event                                                                    |
| Get Event Attachment         | Read   | Get metadata and content for an event attachment                                                 |
| Add Event Attachment         | Write  | Add a small attachment to an event                                                               |
| Find Free Time               | Read   | Return free/busy schedule information for users or resources                                     |
| Get Schedule                 | Read   | Get detailed free/busy schedule information                                                      |
| Find Meeting Times           | Read   | Find meeting time suggestions from attendees and constraints                                     |

## Example prompts

* List my recent unread emails and summarize the most important ones.
* Search my emails for specific topics, senders, or date ranges.
* Help me draft a professional email with proper formatting and tone.
