Outlook MCP / App in amberAI for Administrators

The Outlook MCP (Model Context Protocol) connects Microsoft Outlook to amberAI, allowing users to read and draft emails, directly within their conversations in amberAI.

The Outlook MCP is not pre-installed. It needs to be set up once by an administrator before it becomes available to users in your organization.


Prerequisites

Microsoft Azure Portal

Before configuring the Outlook MCP in amber, an administrator must register an application in the Microsoft Azure Portal and grant the required API permissions.

Go to Azure Portal → Azure Active Directory → App registrations and open your registered amber application. Under API permissions, make sure the following Microsoft Graph permissions are configured:

Permission

Type

Description

Mail.ReadWrite

Delegated

Read and write access to user mail

Mail.Send

Delegated

Send mail as a user

People.Read

Delegated

Read users' relevant people lists

User.ReadWrite

Delegated

Read and write access to user profile



All four permissions are delegated permissions and do not require admin consent.

⚠️ Important – Action Required: After you have configured the permissions in the Azure Portal, please notify your Customer Success Manager via email or Microsoft Teams that the permissions have been set. This step is required so that we can complete the activation of the Outlook MCP for your organization.


Step 2: Configure MCP Actions (Optional)

After setup, you can control which Outlook actions are available to users. Open the Outlook MCP detail view under Admin Settings → Connectors → Apps to see all available MCP Actions. Each action can be individually enabled or disabled using the toggle.

The Outlook MCP provides the following actions out of the box:

Read Only

ActionDescription

Get User (get_user)

Retrieves the profile information of the authenticated user

List Messages (list_messages)

Lists emails from the user's mailbox

Search Messages (search_messages)

Searches for emails by keyword or filter

Search People (search_people)

Searches the user's people list and contacts

Get Message (get_message)

Retrieves the full content of a specific email

Write

Action

Description

Send Email (send_mail)

Composes and sends an email on behalf of the user

Note: Disabling an action here removes it for all users in your organization. Individual users cannot re-enable actions that have been disabled by an admin.


What Users Need to Do

Once the Outlook MCP has been set up, it appears in every user's connector settings. Each user needs to connect once with their own Microsoft account before they can use it.

Connecting to the Outlook MCP

Users go to User Settings → Connectors → Apps, click on the Outlook MCP, and authenticate with their personal Microsoft account via the OAuth flow.

Setting Individual Permissions

After connecting, each user can define how amberAI is allowed to use each tool:


Summary

Task

Responsibility

Add the Microsoft Azure Permissions

Admin

Enable, disable, and configure tools

Admin

Connect personal Microsoft account to the Outlook MCP

User

Set individual tool permissions

User