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

# Microsoft Outlook MCP Setup

> Set up Microsoft Outlook MCP in ApexGenius: sign in on Microsoft's page, review the 6 mail operations, and test with a first read of your mailbox.

**Status: Available.** ApexGenius calls Microsoft Graph, Microsoft's official API, with Microsoft's own browser sign-in. You do not paste an API key or a password. One connection is one mailbox: the one you sign in to. Your calendar is a separate connection, [Outlook Calendar](https://docs.apexgenius.ai/integrations/outlook-calendar.md).

[Explore the Microsoft Outlook connector](https://www.apexgenius.ai/connectors/outlook).

## What you need

* A Microsoft account with an Outlook mailbox
* An ApexGenius account
* At work or school, your Microsoft 365 admin may need to approve ApexGenius first

> [accordion] How to connect Microsoft Outlook
>
> **Before you start**
>
> * An account with permission to use the Microsoft Outlook resources you intend to connect.
>
> **1. Open Microsoft Outlook in Connections**
>
> Choose Connect, or Add connection when offered. Give the connection a name if prompted. If Gateway setup pending appears, contact ApexGenius support before continuing.
>
> **2. Choose the account and review access**
>
> Sign in with your Microsoft work, school or personal account and review the access Microsoft lists: read your mail, send mail as you, and stay signed in. No API key is pasted into ApexGenius. If Microsoft says an admin must approve, ask your Microsoft 365 admin.
>
> **3. Review the connected account and resources**
>
> Confirm the connected mailbox on the connection page. Open Tools to review the reads and the send tool. Sending runs right away when enabled and cannot be recalled.
>
> **4. Check the connection**
>
> Use Test connection or Check again and read the reported status. Add an AI agent from the AI agents page, choose Read only for the first test, and try the question below.
>
> **Try a first question with your AI agent**
>
> ```text theme={"system"}
> Show the subjects and senders of my five most recent Outlook messages. Do not send anything.
> ```
>
> Check that the answer matches what you see in Microsoft Outlook.
>
> [Add your AI agent](https://docs.apexgenius.ai/guides/mcp-setup.md) · [Official Microsoft Outlook instructions](https://learn.microsoft.com/en-us/graph/api/user-list-messages?view=graph-rest-1.0)

## What Microsoft asks you to allow

ApexGenius asks for four permissions, all for the person who signs in:

| Permission | What it is for |
| - | - |
| `User.Read` | See which account signed in |
| `Mail.Read` | Read messages and mail folders |
| `Mail.Send` | Send mail as the signed-in person |
| `offline_access` | Stay connected without signing in again every hour |

## If Microsoft asks for admin approval

Some organizations let only an admin approve a new app. If Microsoft shows a message that you need admin approval, your sign-in stops there and nothing is connected. Ask your Microsoft 365 admin to approve ApexGenius for your organization, then choose Connect again. The table above is what your admin is approving.

## Tools and the Outlook skill

Open **Skills** on the connection to read **MicrosoftOutlook**, or read that MCP prompt in a compatible AI client with `prompts/get`. It covers the first safe read, how to find and read mail, how to send, and what the connector cannot do.

Three ApexGenius tools route the Outlook operations:

| ApexGenius tool | What it does | Access |
| - | - | - |
| `microsoft_outlook_search_operations` | Lists the 6 reviewed Outlook operations with their inputs | Read |
| `microsoft_outlook_read_operation` | Runs the 5 reads: `get_me`, `list_messages`, `get_message`, `list_mail_folders` and `list_folder_messages` | Read |
| `microsoft_outlook_write_operation` | Runs the one write, `send_mail` | Destructive |

The reads cover the signed-in account, the messages in your mailbox, one message as plain text, your mail folders with their unread counts, and the messages in one folder.

Your AI discovers the tools with `apex_search_tools`. Reads use `apex_call_read_tool`; sending uses `apex_call_write_tool`. Writes run immediately. Blocked hides a tool from agents.

## One mailbox per connection

The connection reads and sends from the mailbox of the Microsoft account you signed in with. Shared mailboxes and other people's mail are not included. To use a different account, disconnect and connect again.

## What it cannot do

* It cannot reply, forward or save a draft. `send_mail` sends a new message.
* It cannot read or send attachments.
* It cannot move, flag or delete mail.
* It cannot reach a shared mailbox.
* It does not read your calendar. Connect [Outlook Calendar](https://docs.apexgenius.ai/integrations/outlook-calendar.md) for that.

A sent message cannot be recalled. Microsoft confirms that it accepted the message, which is not proof of delivery. Disconnecting stops future access. It does not unsend a message.

## Connector, tools, and skill

| Layer | What must work |
| - | - |
| Connector | Sign-in completes, the connected Microsoft account is shown, and health is current. |
| Tools | `microsoft_outlook_search_operations`, `microsoft_outlook_read_operation` and `microsoft_outlook_write_operation` are discoverable and a real read such as `get_me` succeeds. |
| Skill | The `MicrosoftOutlook` MCP prompt is readable and routes the agent through discovery, the first read, the read route and the send rule. |

If any row fails, Outlook is **partially ready**. A saved sign-in by itself is not a fully ready connection.

## Troubleshooting

* **Microsoft says you need admin approval:** ask your Microsoft 365 admin to approve ApexGenius, then connect again. See the section above.
* **Unavailable to this account:** check that you are signed in to the intended ApexGenius account and refresh Connections.
* **Wrong mailbox:** disconnect, then connect again and pick the right Microsoft account on Microsoft's page.
* **Reconnect required:** use the connection page to sign in to Microsoft again. This can follow a password change or a new sign-in rule at your organization.
* **Reads fail after a good sign-in:** check that the account you signed in with has an Outlook mailbox.
* **Tool disabled:** the owner has turned the tool off. Review tool access on the connection page.

[Explore the Microsoft Outlook connector](https://www.apexgenius.ai/connectors/outlook) · [Open Microsoft Outlook Connections](https://www.apexgenius.ai/connections/microsoft_outlook)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.