Outlook MCP

Delete a contact by ID.

Delete a draft message by ID.

Delete a calendar event by ID (cancels and notifies attendees if you're the organizer).

Delete a user-created mail folder by ID; refuses well-known folders (inbox, sentitems).

Delete a Focused Inbox per-sender override rule by its ID.

Delete a message — soft delete (to Deleted Items) by default; permanent=True to hard-delete. This is the canonical way to delete a message. Do NOT use outlook_move_message(folder="deleteditems") for deletion.

Delete a task from a Microsoft To Do list.

Remove an attachment from a To Do task.

Download an attachment to `save_path` on the host, or return it with `as_content=True`. `save_path` is resolved inside the configured attachments directory (`attachments_dir`, an `attachments` folder in the settings directory by default) — a bare filename lands there; a path outside it is refused. Same directory for reads and writes. `as_content` writes nothing; 10 MB at most.

Download a To Do task attachment to a local file, or return it with `as_content=True`. `save_path` resolves inside the configured attachments directory; the write is atomic (temp file + replace), so a failed download never truncates a file already staged there. `as_content` writes nothing; 10 MB at most.

Find events by the `key` given to outlook_create_event or outlook_update_event. Any date. Searches the default calendar, or `calendar`. Returns events and series masters, not occurrences.

Set the follow-up flag on a message. `status` is "flagged", "complete", or "notFlagged".

Forward an existing message to new recipients, with optional comment.

Get one full contact by ID.

Get one event by ID: body, attendees, organizer, recurrence, type, show_as, anchor zone, key, attachments (metadata). `recurrence` comes back in the same shape outlook_create_event accepts; `type` is "singleInstance", "seriesMaster", "occurrence" or "exception". `start`/`end` are UTC; `original_start_time_zone` is the zone the event is anchored in.

Pre-send check for recipients: out-of-office, delivery limits, mailbox-full warnings.

Get full To Do task details: notes (`body`), checklist items, due, recurrence flag. Use this for one task's sub-steps and notes; use outlook_list_tasks for overviews. `checklist_items` are ordered unchecked-first, matching the To Do client. `list_id` is only needed when the task lives in a non-default list.

List attachments on a message — returns IDs, names, sizes, and content types.

List all calendars available to the authenticated user (primary + secondary).

List the user's master category definitions (names + colors). Provides the valid values for outlook_categorize_message.

List contacts with cursor pagination. Use for one-shot queries; use outlook_list_contacts_delta for polling/recurring agents.

List only contact changes since the last call. Use this for polling/recurring agents — typically 10x cheaper than outlook_list_contacts after the first call. Use outlook_list_contacts for one-shot queries. Example: first call: outlook_list_contacts_delta(); next: outlook_list_contacts_delta(delta_token=<token from prior response>). is_deleted=True items are tombstones (drop cached payload). has_more=True means drain immediately by passing the returned delta_token back.

List messages in the Drafts folder with cursor pagination.

List calendar events in a date range (expands recurring instances). Use for one-shot queries; use outlook_list_events_delta for polling/recurring agents. Pass concise=True for day-at-a-glance scans: drops organizer, response_status, type and show_as; adds is_organizer and attendees_count; spells is_online as is_online_meeting. `calendar`: a display name or an ID from outlook_list_calendars; omit for the default calendar. A cursor continues the listing it came from.

List only calendar event changes within a window since the last call. Use this for polling/recurring agents — typically 10x cheaper than outlook_list_events after the first call. Use outlook_list_events for one-shot queries. Example: first call: outlook_list_events_delta(start="2026-05-22T00:00:00Z", end="2026-05-29T00:00:00Z"); next: outlook_list_events_delta(delta_token=<token>). start/end (ISO 8601) required on first call only; the cursor encodes the window thereafter. is_deleted=True items are tombstones. has_more=True means drain immediately.

List mail folders with message counts, parent_id, and child count. Default is top-level only; pass recursive=True to walk the full tree, each folder with the `path` that folder arguments accept.

List messages in one folder with structured filters (read, sender, date, category, Focused). Use this for folder-scoped browsing; use outlook_search_mail for KQL full-text search across all folders. For polling/recurring agents use outlook_list_inbox_delta (typically 10x cheaper after the first call). Example: outlook_list_inbox(folder="Junk Email", unread_only=True, count=5) `folder` accepts display names, well-known names ("inbox", "junkemail"), or Graph IDs — prefer names. Pass concise=True to drop large fields (preview, categories) — ~10x fewer tokens. Pass uncategorized_only=True to ret…

List only inbox changes since the last call. Use this for polling/recurring agents — typically 10x cheaper than outlook_list_inbox after the first call. Use outlook_list_inbox for one-shot snapshots. Example: first call: outlook_list_inbox_delta(); next: outlook_list_inbox_delta(delta_token=<token from prior response>). is_deleted=True items are tombstones (drop cached payload). has_more=True means drain immediately by passing the returned delta_token back.

List the user's Focused Inbox per-sender override rules. Each override forces mail from a given sender into Focused or Other regardless of Graph's inference.

List attachments on a To Do task (id, name, size, content_type) with pagination. Use `outlook_download_task_attachment` with an id from here to save the content. has_more=True means pass next_cursor back for the next page.

List all Microsoft To Do task lists for the current user.

List tasks in a To Do list with optional `status` filter. `status`: "notStarted", "inProgress", or "completed".

List all messages in a conversation thread, chronological order. Needs `conversation_id` from a message's metadata. Pass concise=True to drop large fields (quoted prior-message text in each preview) — ~10x fewer tokens on long reply chains.

Mark a single message as read or unread (set is_read=True or False).

Move a message to another folder (removes from source). Use outlook_copy_message to duplicate without removing the source. For deletion use outlook_delete_message (not move to "deleteditems"). `folder` accepts display names, well-known names ("inbox", "archive", "deleteditems"), or Graph IDs — prefer names.

Get one full message by ID or Message-ID (`<abc@example.com>`). `format` is "text", "html", or "full" (both). Pass include_deferred_send=True to also return the scheduled-send time (PR_DEFERRED_SEND_TIME) as deferred_send_datetime — useful when recreating a delayed draft. Pass concise=True to drop large fields (body, body_html) and return a 200-char body_preview — ~10x fewer tokens for triage scans. include_sender_auth=True adds sender_authentication: did Microsoft verify the From domain?

Bulk read up to 20 messages by ID via $batch — use NOT N outlook_read_message calls. Per-message shape in `messages` matches outlook_read_message byte-for-byte for the same (format, concise, include_deferred_send, include_sender_auth). Ordering follows input `message_ids`. Returns `{messages, failures, requested, succeeded, failed}` — 404s on some IDs are surfaced in `failures` without failing the whole call (partial-failure tolerant). Example: outlook_read_messages(message_ids=[id1, id2, id3], concise=True) Hard cap of 20 (Graph $batch limit).

Reclassify ONE message's Focused/Other placement. `classification` is "focused" or "other". Use this to fix a single message; use outlook_set_inbox_override for a sticky rule that affects future messages from the same sender.

Remove a single attachment from a draft message by attachment ID.

Remove one attachment from an event (IDs from outlook_get_event's `attachments`).

Rename a user-created mail folder by ID.

Reply (or reply-all) to an email message. Use this for email; use outlook_rsvp for calendar meeting invites.

RSVP to a calendar meeting invite. `response` is "accept", "decline", or "tentative". Use this for meeting invites; use outlook_reply to reply to a regular email message.

Search contacts by name or email using KQL query syntax. phone (instead of query) finds a number written any way, with or without country code.

Full-text search mail with KQL across all folders (or one, if `folder` is set). Use this for "find emails about X"; use outlook_list_inbox for structured filters scoped to a single folder. Example: outlook_search_mail(query="from:sarah@acme.com received>=2026-01-01", count=10) `query` is Microsoft KQL (from:, subject:, received>=, hasattachment:true, AND/OR/NOT). Operators must be UPPERCASE — lowercase `and` is matched as a literal term. Two terms with no operator between them broaden the search; use AND explicitly to narrow. Pass concise=True to drop large fields (preview, categories) — ~10…

Send an existing draft (pair with outlook_create_draft for human-review send flow).

Send an email immediately, no human review. For human-review workflows use outlook_create_draft + outlook_send_draft instead. For replying to an existing message use outlook_reply; for calendar invites use outlook_rsvp. Pass reply_to to route recipient replies to a different address (e.g. a shared team alias).

Send an email with file attachments; auto-switches to upload-session for files >3MB. `attachment_paths` resolve inside the configured attachments directory (`attachments_dir`, an `attachments` folder in the settings directory by default) — a bare filename is looked up there, and a path outside it is refused. `attachments`: inline files [{name, content_base64, content_type?}], up to 3MB each. Pass reply_to to route replies to a different address.

Create or update a sticky Focused/Other rule for a sender (upsert, case-insensitive). Use this to permanently change classification for FUTURE messages from a sender; use outlook_reclassify_message to fix ONE existing message. Example: outlook_set_inbox_override(sender_email="marketing@acme.com", classify_as="other") Returns status: "created" or "updated".

Update a checklist item (partial patch — only provided fields change). `is_checked=True` marks a sub-step done; Graph maintains the checked timestamp from it. Renaming passes `display_name`.

Update an existing contact (partial patch — only provided fields change). An address takes the shape outlook_get_contact returns — any subset of {"street", "city", "state", "postal_code", "country_or_region"} — and REPLACES that whole address, so pass back every part you want to keep. Omit it to leave it untouched. phone_type ("mobile", "business", "home") picks the field; business/home REPLACE that list. clear_phones empties those types: phone_type="business", clear_phones=["mobile"] moves it. title is the name prefix ("Dr.", "Ms."), shown in the display name — not the job. birthday is a dat…

Update an existing draft (partial patch). Pass is_html=True when body is HTML — required when overwriting a draft originally composed as HTML (consumer Outlook rejects Text-over-HTML PATCH). Pass reply_to=[...] to overwrite Reply-To; reply_to=[] to clear it. Pass deferred_send_datetime (ISO 8601) to set the scheduled-send time; empty string clears it.

Update fields on an existing event (partial patch — only provided fields change). `recurrence` takes the same shapes as outlook_create_event and converts a single event into a series, or replaces an existing series' pattern. Omit it to leave any recurrence alone; pass remove_recurrence=True to turn a series back into a single event, keeping the first occurrence's time (the two are mutually exclusive). `attendees` REPLACES the whole guest list (Graph has no add-one operation) and sends invitations to everyone on it plus cancellations to anyone dropped — pass the full intended list; [] removes …

Update fields on a To Do task (partial patch — only provided fields change).

Attach a local file to a To Do task via inline base64 POST (1 byte – 20 MiB). `file_path` resolves inside the configured attachments directory. Larger files are refused up front: Graph caps the request body at 30 MB and base64 inflates the file 4/3, so 20 MiB is the honest ceiling.

Get the authenticated user's profile (display name, email, ID).