# Outlook MCP Server

> **Outlook MCP Server** is a hosted, multitenant Model Context Protocol (MCP) server run by **MewCP** (https://mewcp.com), giving AI agents managed access to Outlook.
>
> MewCP takes care of all MCP infrastructure for you — credential storage, OAuth flows,
> token refresh, and production-grade auto-scaling — so your AI agents can connect to
> third-party services and run freely without you managing any MCP server yourself.
>
> Server page:  https://mewcp.com/mcp/outlook
> MewCP docs:   https://docs.mewcp.com
> All servers:  https://mewcp.com/servers (JSON: https://mewcp.com/api/servers)
> About MewCP:  https://mewcp.com/llms.txt

---

## About

Microsoft Outlook MCP Server gives AI agents full control over Outlook email and calendar workflows, including reading and sending emails, managing attachments, organizing mail, scheduling and updating meetings, managing contacts, and creating tasks.

---

## Details

- Server ID: `outlook`
- Version: v1.0.0
- Tools: 37
- Authentication: OAuth, managed by MewCP
- Calls served: 1276
- Transport: http

---

## Access

The gateway URL below serves your **entire MewCP toolset**, not this server on its
own. Pasting a config snippet is not enough — Outlook has to be in the toolset
first. In order:

1. Add Outlook to your toolset at https://mewcp.com/mcp/outlook
2. Connect your Outlook account (OAuth); MewCP stores the credential and attaches it to each call
3. Add the gateway URL to your client (see Connect below). It signs in with OAuth
   the first time it connects, so there is no key to copy.

Once connected, an agent does **not** see this server's tools as top-level tools.
It sees four meta-tools and reaches everything through them:

- `search(query)` — find tools by keyword across the toolset
- `get_schema(tools)` — full description and arguments for the tools you picked
- `list_accounts(provider)` — only when one app has several connected accounts
- `call_tool(server_maskedId, tool_name, args)` — execute

So the list below is what `search` can return for this server, not a set of
callable tool names on their own.

---

## Tools (37)

Descriptions are truncated to 160 characters; call `get_schema`
for the full text and the argument schema. Where a tool is annotated, its type
is shown — treat `destructive` as irreversible.

- `get_user` _(read)_ — Gets the signed-in user's own profile, returning properties such as displayName, mail, jobTitle, userPrincipalName, and id from the default property set unless…
- `list_users` _(read)_ — Lists user objects in the directory, returning the default property set (businessPhones, displayName, givenName, id, jobTitle, mail, mobilePhone,…
- `create_user` _(write)_ — Creates a new user object in the directory and returns the created user's default property set, including the `id` needed by get_user, update_user, and…
- `update_user` _(write)_ — Updates properties on the signed-in user's own profile, or on another user's profile when `user_id` is given (requires higher-privileged admin permissions).…
- `delete_user` _(destructive)_ — DESTRUCTIVE — REQUIRES EXPLICIT USER CONFIRMATION BEFORE CALLING. Permanently deletes a user object by id or userPrincipalName. The user's mailbox, license…
- `get_users_delta` _(read)_ — Gets incremental changes to user objects since the last delta query, returning changed users plus either `odata_next_link` (more pages in this round) or…
- `create_draft_message` _(write)_ — Creates a draft of a new message and saves it to the Drafts folder without sending it. Returns the created draft, including the `id` needed to send it later…
- `create_draft_to_forward_message` _(write)_ — Creates a draft Forward message for an existing message, which can be edited and sent later with send_draft_message. Specify recipients via either the…
- `create_draft_to_reply_all` _(write)_ — Creates a draft Reply All message for an existing message, addressed to the sender and all original recipients, which can be edited and sent later with…
- `create_draft_to_reply` _(write)_ — Creates a draft Reply message for an existing message, addressed to the sender, which can be edited and sent later with send_draft_message. Specify a lead-in…
- `forward_message` _(write)_ — Forwards an existing message to the given recipients in a single call and saves the forward to Sent Items. Requires at least one recipient in `toRecipients`;…
- `get_message` _(read)_ — Retrieves the full properties of a single message by its id, including sender, recipients, body, and read/draft/attachment flags. Use `select` to request only…
- `list_messages` _(read)_ — Lists messages in the signed-in user's mailbox, including the Deleted Items and Clutter folders, with optional OData filtering, sorting, searching, and paging.…
- `reply_all_message` _(write)_ — Replies to the sender and all recipients of an existing message in a single call and saves the reply to Sent Items. Use create_draft_to_reply_all instead if…
- `reply_message` _(write)_ — Replies to the sender of an existing message in a single call and saves the reply to Sent Items. Use `message` to override properties such as adding extra…
- `send_draft_message` _(write)_ — Sends a previously created draft message by its id and saves it to Sent Items. The draft must come from create_draft_message, create_draft_to_reply,…
- `send_mail` _(write)_ — Composes and sends a new message in a single call without creating a draft first, saving it to Sent Items unless `saveToSentItems` is set to false. `message`…
- `update_message` _(write)_ — Updates fields on an existing message — most body/recipient/subject fields are updatable only while the message is still a draft. Supply only the fields to…
- `delete_message` _(destructive)_ — DESTRUCTIVE — REQUIRES EXPLICIT USER CONFIRMATION BEFORE CALLING. Deletes a message by moving it to Deleted Items. This is a soft delete — the message is…
- `copy_message` _(write)_ — Copies a message to a destination folder, leaving the original message untouched at its original id. Returns the new copy, which gets its own id in the…
- `get_message_delta` _(read)_ — Gets messages added, updated, or deleted in a mail folder since the last sync round, returning a page of changes plus either `odata_next_link` (more pages in…
- `move_message` _(write)_ — Moves a message to a destination folder. This creates a new copy of the message there and removes the original — the id the message had before the move stops…
- `permanently_delete_message` _(destructive)_ — DESTRUCTIVE — REQUIRES EXPLICIT USER CONFIRMATION BEFORE CALLING. Permanently deletes a message into the mailbox's purges folder, bypassing Deleted Items…
- `list_calendars` _(read)_ — Lists all the signed-in user's calendars, or the calendars in a specific calendar group. Returns the full set in one response. The `id` of each calendar is…
- `get_calendar` _(read)_ — Gets the properties of a calendar — the signed-in user's default calendar if `id` is omitted, or a specific one of their other calendars otherwise.
- `list_events` _(read)_ — Lists single-instance meetings and series masters in the signed-in user's mailbox — not expanded recurring occurrences, use list_calendar_view for that.…
- `create_event` _(write)_ — Creates a new event on the signed-in user's default calendar. Including `attendees` sends meeting invitations immediately — this can't be suppressed. Returns…
- `get_event` _(read)_ — Retrieves the full properties of a single event by its id. Use `select` to request only specific properties.
- `update_event` _(write)_ — Updates fields on an existing event. Supply only the fields to change; others keep their current value. An update that includes only `attendees` sends a…
- `delete_event` _(destructive)_ — DESTRUCTIVE — REQUIRES EXPLICIT USER CONFIRMATION BEFORE CALLING. Deletes an event by moving it to Deleted Items. If the event is a meeting, this sends a…
- `cancel_event` _(destructive)_ — DESTRUCTIVE — REQUIRES EXPLICIT USER CONFIRMATION BEFORE CALLING. Sends a cancellation message from the organizer to all attendees and cancels the meeting,…
- `accept_event` _(write)_ — Accepts an event invitation on the signed-in user's calendar. Applies to user calendars only, not group calendars. Returns no content on success (202 Accepted).
- `tentatively_accept_event` _(write)_ — Tentatively accepts an event invitation on the signed-in user's calendar, optionally proposing a new time. Applies to user calendars only, not group calendars.…
- `decline_event` _(write)_ — Declines an event invitation on the signed-in user's calendar, optionally proposing a new time. Applies to user calendars only, not group calendars. Returns no…
- `find_meeting_times` _(read)_ — Finds candidate meeting times based on attendee free/busy availability, location, and time constraints, without creating an event. Once a time is picked,…
- `get_free_busy_schedule` _(read)_ — Gets free/busy availability for a set of users, distribution lists, or resources over a specified time period. To get ranked meeting-time suggestions instead…
- `list_calendar_view` _(read)_ — Gets events for a date range from the default calendar, expanding recurring series into individual occurrence instances — use this for "what's actually on the…

---

## Connect

- URL: https://gateway.mewcp.com/personal/mcp
- Transport: Streamable HTTP (remote). Nothing to install.
- Sign-in: OAuth. On first connect the client opens a browser window to sign in
  to MewCP and approve access. No API key.
- Headless clients (SDKs, servers without a browser) send an API key instead:
  `Authorization: Bearer <API_KEY>`, key from https://mewcp.com/dashboard/api-keys

Agents setting themselves up: follow https://mewcp.com/SKILL.md

Step-by-step guide per client:

- Claude Desktop: https://mewcp.com/mcp/outlook/connect/claude
- ChatGPT: https://mewcp.com/mcp/outlook/connect/chatgpt
- Grok: https://mewcp.com/mcp/outlook/connect/grok
- DeepSeek Harness: https://mewcp.com/mcp/outlook/connect/dsh
- Mistral Vibe: https://mewcp.com/mcp/outlook/connect/mistral-vibe
- VS Code: https://mewcp.com/mcp/outlook/connect/vscode
- Cursor: https://mewcp.com/mcp/outlook/connect/cursor
- Codex: https://mewcp.com/mcp/outlook/connect/codex
- Claude Code: https://mewcp.com/mcp/outlook/connect/claude-code
- OpenCode: https://mewcp.com/mcp/outlook/connect/opencode
- OpenClaw: https://mewcp.com/mcp/outlook/connect/openclaw
- Antigravity: https://mewcp.com/mcp/outlook/connect/antigravity
- Hermes: https://mewcp.com/mcp/outlook/connect/hermes
- Kimi Code: https://mewcp.com/mcp/outlook/connect/kimi-code
- Grok Build: https://mewcp.com/mcp/outlook/connect/grok-build
- Devin Desktop: https://mewcp.com/mcp/outlook/connect/devin-desktop
- Zed: https://mewcp.com/mcp/outlook/connect/zed
- Muse Code: https://mewcp.com/mcp/outlook/connect/muse-code
- Cline: https://mewcp.com/mcp/outlook/connect/cline
- Kilo Code: https://mewcp.com/mcp/outlook/connect/kilo-code
- Kiro: https://mewcp.com/mcp/outlook/connect/kiro
- Junie: https://mewcp.com/mcp/outlook/connect/junie
- Amp: https://mewcp.com/mcp/outlook/connect/amp
- Qwen Code: https://mewcp.com/mcp/outlook/connect/qwen-code
- Goose: https://mewcp.com/mcp/outlook/connect/goose
- Python: https://mewcp.com/mcp/outlook/connect/python
- TypeScript: https://mewcp.com/mcp/outlook/connect/typescript