outlook-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| OUTLOOK_AUTH | No | Force a token source: azure-cli, token, token-file, command, or cookie. | auto |
| OUTLOOK_DEBUG | No | Set to 1 to log each request (action and status only) to stderr. | off |
| OUTLOOK_CANARY | No | Canary value used together with OUTLOOK_COOKIE. | |
| OUTLOOK_COOKIE | No | Experimental, untested OWA cookie used as an authentication source. | |
| OUTLOOK_ORIGIN | No | OWA origin. | https://outlook.cloud.microsoft |
| OUTLOOK_TIMEZONE | No | Windows time zone ID (e.g. GMT Standard Time) used for times given without an offset. Defaults to the mailbox setting. | |
| OUTLOOK_AZ_TENANT | No | Optional tenant passed to the Azure CLI token source (the default authentication source). | |
| OUTLOOK_READ_ONLY | No | Set to 1 to register only the 15 read-only tools. | off |
| OUTLOOK_TOKEN_FILE | No | Path to a file containing a raw token or JSON with accessToken/access_token. Re-read when expired or rejected. | |
| OUTLOOK_ACCESS_TOKEN | No | Static bearer token with audience https://outlook.office.com. Must be replaced when it expires (~1 hour). | |
| OUTLOOK_TOKEN_COMMAND | No | Command that prints a token or JSON. Re-run when the token expires or is rejected. | |
| OUTLOOK_ANCHOR_MAILBOX | No | Override the X-AnchorMailbox routing header (defaults to the value derived from the token, e.g. PUID:…@tenant). | |
| OUTLOOK_MAX_DOWNLOAD_MB | No | Maximum attachment size in MB for downloads and uploads. | 25 |
| OUTLOOK_ATTACHMENTS_ORIGIN | No | Attachment download host. | https://attachments.office.net |
| OUTLOOK_REQUEST_TIMEOUT_MS | No | Per-request timeout in milliseconds. | 30000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Tools for the user's Microsoft 365 Outlook mailbox (mail, calendar, contacts) via Outlook on the web. IDs returned by one tool can be passed to others. Times in results are UTC; call get_mailbox_info for the user's time zone. send_message, reply_message, forward_message, send_draft, create_event with attendees, update_event, delete_event and respond_to_event contact other people — confirm with the user before using them. Prefer create_draft when the user has not explicitly asked to send.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_mailbox_infoA | Get the signed-in user's name, email address, time zone (Windows ID, used for times given without an offset), storage quota, and inbox/drafts counts. |
| list_categoriesA | List the mailbox's category names and colors (for categorize_messages and events). |
| list_foldersA | List mailbox folders with their paths, IDs, well-known names and item/unread counts. Use the returned path or ID wherever a folder is expected. |
| create_folderB | Create a mail folder, optionally inside another folder. |
| rename_folderC | Rename a folder. |
| move_folderB | Move a folder (with its contents) into another folder. |
| delete_folderA | Delete a folder and everything in it. By default it is moved to Deleted Items; built-in folders cannot be deleted. |
| list_messagesA | List messages in a folder, newest first, with sender, subject, preview, read/flag state and IDs. Page with offset/nextOffset. Times are UTC. |
| search_messagesA | Find messages by text, sender, recipient, subject, date, category, read/flag state or attachments. Works by scanning the newest messages of each folder (scanLimit per folder) and matching subject, sender, recipient display names and the ~250-character preview; it does not search full bodies or attachment contents. All given criteria must match. Searches all mail folders except Deleted Items, Junk, Drafts and Outbox unless folders is given. |
| get_messageA | Get a message with full body (a string; see bodyFormat), recipients and file attachments (inline images are only counted; list_attachments shows them). Does not mark it read unless markAsRead is true. |
| get_threadA | Get every message in a conversation (across folders), oldest first. Each body contains only the new text of that message, without quoted history. |
| send_messageA | Compose and immediately send a new email (a copy is saved in Sent Items). Use create_draft instead if the user wants to review it first. |
| create_draftA | Save a new email in Drafts without sending it. Returns the draft ID for update_draft, add_attachment and send_draft. |
| update_draftA | Change a draft's subject, body, importance or recipients. Recipient lists replace the existing ones; an empty list clears them. |
| send_draftB | Send an existing draft (including reply/forward drafts). |
| reply_messageA | Reply (or reply-all) to a message. The original is quoted below your text. Sends immediately unless send is false, in which case a draft is saved and its ID returned. |
| forward_messageB | Forward a message (with its attachments) to new recipients. Sends immediately unless send is false. |
| mark_messages_readB | Mark messages as read or unread (no read receipts are sent). |
| flag_messagesC | Set the follow-up flag on messages. |
| categorize_messagesA | Set, add or remove categories on messages. See list_categories for the mailbox's category names. |
| move_messagesB | Move messages to another folder (e.g. archive). Message IDs stay valid after moving. |
| copy_messagesB | Copy messages to another folder; returns the IDs of the copies. |
| delete_messagesA | Delete messages. By default they are moved to Deleted Items (recoverable); permanent deletion cannot be undone. |
| list_attachmentsC | List the attachments of a message, event or contact. |
| download_attachmentA | Download a file attachment. With savePath the file is written to disk; otherwise text files are returned as text, images as images, and other files as an embedded base64 resource (up to 10 MB). |
| add_attachmentB | Attach a file to a draft (or to an event/contact you own). |
| remove_attachmentA | Remove an attachment from a draft (or from an event/contact you own). |
| list_calendarsB | List the mailbox's calendars (the default one is wellKnownName "calendar"). |
| list_eventsA | List calendar events (recurring events are expanded into occurrences) that overlap a time range, sorted by start. Defaults to the next 7 days from today (UTC). Returned times are UTC. |
| get_eventA | Get full event details: description, attendees with their responses, organizer, online meeting link, recurrence master. |
| create_eventA | Create a calendar event. If attendees are given this is a meeting and invitations are emailed to them immediately. Set isOnlineMeeting to add a Microsoft Teams link (if the tenant allows it). |
| update_eventA | Change an event you organize. Only given fields change; attendee lists replace the existing ones. For meetings, attendees are sent an update unless notifyAttendees is false. |
| delete_eventA | Delete an event. For meetings you organize, attendees are sent a cancellation unless notifyAttendees is false. To decline someone else's meeting, use respond_to_event instead. |
| respond_to_eventA | Accept, tentatively accept or decline a meeting invitation, optionally with a message to the organizer. |
| list_contactsA | List personal contacts alphabetically. Use search_people to find people by name, including the organization directory. |
| get_contactB | Get all details of a personal contact. |
| search_peopleA | Find people by name or email address in the organization directory (global address list) and/or personal contacts. Useful for looking up someone's email address before sending. |
| create_contactC | Create a personal contact. |
| update_contactA | Update a personal contact. Only given fields change; an empty string clears a field and emails replaces all addresses. |
| delete_contactA | Delete a personal contact (moved to Deleted Items unless permanent). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 40 tools
Tools are cleanly separated along resource+action lines: message read paths (list/search/get/get_thread), draft lifecycle (create/update/send_draft vs send_message/reply/forward), and folder/calendar/contact operations never collide. Near-overlaps like delete_messages vs move_messages or search_people vs list_contacts are explicitly disambiguated in the descriptions, and even attachment listing vs downloading is distinguished.
Every tool follows a strict snake_case verb_noun pattern (list_folders, get_message, create_event, delete_contact, mark_messages_read). Plurals and resource nouns are used consistently so the target object is always obvious from the name.
40 tools is well above the well-scoped range; the surface is large because it spans mail, drafts, folders, attachments, calendar, contacts and categories in one server. Each tool is individually justified, but the volume forces an agent to sift through a broad catalog for routine tasks.
Lifecycle coverage is strong: mail read/search/send/draft/reply/forward/flag/categorize/move/copy/delete, folder CRUD+move, attachment add/remove/list/download, event CRUD plus respond_to_event, and contact CRUD plus directory search. Remaining gaps are peripheral (inbox rules, out-of-office, creating/deleting categories or calendars, bulk event ops).