Connect Outlook to Your AI Agent

Ask your AI assistant to review messages, compose a draft for you to check, or update your out-of-office replies. Choose MCP or oo CLI + Skill.

15 toolsOAuthMCP / oo CLI + Skill

20,000 free app calls every month(paid services billed separately)

Start Working with Outlook ↓

Start Working with Outlook

Authorize your Microsoft account to connect your Outlook mailbox.

Check Resource Access First

A Microsoft account with an Outlook mailbox you can access.

Connect Outlook

Sign in to OOMOL, select your team, and create the Outlook connection using a supported authorization method. Check that the connection is active, then use the same team in your MCP configuration or oo CLI login.

Connect Outlook
  • A Microsoft account with an Outlook mailbox you can access.
  • Reading, drafting, sending, and changing mailbox settings require their respective permissions. State whether to save a draft or send a message.
Choose Your Access Method

For clients that support remote HTTP MCP and custom authentication headers.

  1. Open the MCP setup page, sign in, and select the team containing your application connection. Use Copy MCP Configuration to get the key and headers.
  2. Add the configuration using the MCP client instructions below, then reconnect your client.
  3. Copy the read-only verification task into your AI chat and run it.
Configure MCPMCP Client Configuration→

For agents that can run terminal commands and use the oo Skill.

  1. Follow the agent setup page to install oo CLI and the oo Skill.
  2. Sign in to the OOMOL team containing your application connection. Use oo login --team <team-name> with your team name.
  3. Copy the read-only verification task into your agent chat and run it.
Set Up oo CLI + SkillCLI Installation Guide→

MCP Client Configuration

Get MCP Configuration

Replace the placeholders with the key and team name from the OOMOL setup page. Keep credentials private and preserve other server entries.

Generic HTTP

In any client that supports remote Streamable HTTP MCP and custom headers, add a remote MCP server using the values below. Get the complete key and team from OOMOL’s MCP setup page; field names and configuration formats vary by client.

URL
https://connector.oomol.com/v1/mcp
Transport
Streamable HTTP
Authorization
Bearer <mcp-api-key>
x-oo-team-name
<team-name>

Replace the placeholders with your own values. Send Authorization as Bearer followed by the MCP key, and x-oo-team-name as the team containing your connection. Prefer the client’s secret-input or environment-variable support. A URL-only setup without these headers is incomplete.

Verify the Connection
  1. Reconnect the server in your client and check that it can list OOMOL tools such as connector_list_apps. If connection fails, check the URL and both authentication headers.
  2. Run the read-only verification task in a new AI chat to check access to your resource and its data.

Look for OOMOL tools such as connector_list_apps and connector_search_actions. They discover and run Outlook actions; each action may not appear as a separate MCP tool. Frequently Asked Questions →

Verify Your First Outlook Query

Copy this read-only task into a new AI chat. If it fails, check the FAQ.

Choose Your Access Method

Verify Your First Outlook Query

Check that the returned resource identifier matches your target and review the query results.

Use OOMOL MCP only. Check that Outlook has an active connection in the configured OOMOL team. Read the mailbox profile and report its address. List at most 5 recent messages, showing only returned IDs, subjects, senders, and received times. Do not fetch full bodies or attachments or mark messages as read. Ask me to choose when the target is unclear. Report only actual results, identify the selected resource, and distinguish empty results from access errors. Do not create, update, delete, or send anything.

Try a Outlook Task

Replace the bracketed values before copying a task. Some tasks modify data; confirm the target and operation before running them.

Choose Your Access Method

Summarize Selected Email

Review messages from a sender and date range to identify requests and deadlines.

Use OOMOL MCP only. Read Outlook messages from [sender email] between [start date] and [end date]. Summarize requests and deadlines, with each source message identified.

Prepare a New Email Draft

Compose an email from your instructions and save it for review.

Use OOMOL MCP only. Draft an Outlook email to [recipient email] with subject “[subject]” using these points [notes]. Save it as a draft for my review; do not send it.

Set Out-of-Office Replies

Set scheduled automatic replies with separate messages for internal and external senders.

Use OOMOL MCP only. Set Outlook automatic replies from [start date and time] to [end date and time] in [time zone]. Use “[internal reply]” for internal senders and “[external reply]” for all external senders.

Revise a Saved Draft

Update an existing draft with the wording you supply.

Use OOMOL MCP only. Update Outlook draft [message ID] with this body [revised text]. Keep it as a draft for review.

Outlook Tools

This Outlook integration works with messages, drafts, and mailbox settings. Use your connected Microsoft account to read email and prepare or send messages.

Read Mailbox Messages

List mailbox folders, filter messages, and read individual email content.

Draft and Send Email

Create or revise drafts, send a reviewed draft, and reply to existing messages.

Manage Mailbox Settings

Read or update automatic replies, time zone, and working hours.

15 tools

Get Profile

Get the current Outlook account profile from Microsoft Graph so you can identify the connected mailbox.

outlook.get_profile

List Mail Folders

List the root-level Outlook mail folders for the connected mailbox, with optional hidden folders and field selection.

outlook.list_mail_folders

List Messages

List Outlook messages from the mailbox or from a specific mail folder, with support for OData filters, sorting, field selection, and pagination.

outlook.list_messages

Get Message

Get a single Outlook message by message ID, including message metadata and optional body formatting.

outlook.get_message

Move Message

Move an Outlook message to another folder in the same mailbox, including Archive or Deleted Items. Use the returned message ID for subsequent operations because moving can change it.

outlook.move_message

Archive Message

Move an Outlook message to the mailbox's Archive folder. Use the returned message ID for subsequent operations. This does not move messages to an Exchange Online archive mailbox.

outlook.archive_message

Delete Message

Delete an Outlook message using the standard mailbox deletion operation. To explicitly move a message to Deleted Items, use move_message with destinationId deleteditems.

outlook.delete_message

Set Message Read

Mark an Outlook message as read or unread.

outlook.set_message_read

Create Draft

Create a new Outlook draft message with subject, body, recipients, and other writable message properties.

outlook.create_draft

Update Draft

Update an existing Outlook draft message. Use this to revise the subject, body, recipients, or other draft-only properties before sending.

outlook.update_draft

Send Draft

Send an existing Outlook draft message by message ID.

outlook.send_draft

Send Email

Send a new Outlook email in a single operation, without creating a standalone draft first.

outlook.send_email

Reply Email

Reply to an existing Outlook message with either a comment or a replacement body, and optionally add more recipients to the reply.

outlook.reply_email

Get Mailbox Settings

Get the current Outlook mailbox settings, including automatic replies, locale, time zone, and working hours.

outlook.get_mailbox_settings

Update Mailbox Settings

Update Outlook mailbox settings such as automatic replies, locale, time zone, working hours, and date or time formatting.

outlook.update_mailbox_settings

Frequently Asked Questions

Why can I connect but not read my resource?

Use the OOMOL team containing your active application connection. Application authorization, the MCP key, and resource permissions are separate checks. Inspect the tool error and confirm the resource ID and query range. Report empty results separately from access errors; keep keys private. For Outlook, confirm the connected mailbox and mail-reading permission. Profile access does not prove message access. Check the selected folder and filters when results are empty; shared mailboxes require separate verification.

Can I save a draft without sending it?

Yes. Draft creation and sending are separate operations. Ask to save a draft, then review it in Outlook before requesting that it be sent.

Does asking AI to reply send an email?

The reply operation sends a reply to an existing message. If you only want wording to review, ask for a proposed reply in the conversation instead of asking it to send.

Can I schedule automatic replies?

Yes. Provide the start and end times, time zone, reply text, and whether external senders should receive it. Mailbox settings permission is required.

Can this integration create Outlook calendar events?

The operations here cover email and mailbox settings. They do not include creating or changing calendar events.