Outlook MCP

Add a checklist item (sub-step) to a To Do task.

Add attachments to an existing draft; 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. Returns new attachment IDs for later removal via outlook_remove_draft_attachment.

Attach files to an event; auto-switches to upload-session for files >3MB. `attachment_paths` resolve inside `attachments_dir`, as for outlook_attach_to_draft. Attendees get the files with the event's next update. Returns new attachment IDs.

Check authentication status. Run `outlook-mcp auth` on the host if needed.

Triage up to 20 messages in one $batch call. `action` is "move", "flag", "categorize", or "mark_read". Example: outlook_batch_triage(message_ids=[id1, id2], action="move", value="Archive") `value` is the action target (folder name for move, status for flag/mark_read, category name for categorize). Hard cap of 20.

Set categories on a message (replaces the full list). Example: outlook_categorize_message(message_id=..., categories=["Follow-up", "Pricing"])

One structured "since last call" digest across mail, events, and contacts. Use this for recurring agent loops (morning brief, hourly inbox sweep) — one call returns counts, urgent_flagged mail, by-sender rollup, plus new/cancelled events and contacts counts. Use the three individual delta tools (outlook_list_inbox_delta, outlook_list_events_delta, outlook_list_contacts_delta) when you need raw item lists or per-resource control. Example: first call: outlook_changes_since(); next: outlook_changes_since(delta_tokens=<delta_tokens from prior response>). First call covers the last `fallback_window_hours` (default 24); later calls (tokens passed back) return only what changed. Replace stored delta_tokens with the returned dict; never merge them. `has_more` true: a resource stopped early; pass the returned dict back. Each resource's token is independent — drop one stale token without re-syncing the others. If Graph 410s on a token (`syncStateNotFound`), that resource auto-resyncs and `_meta.resync` lists which one. `urgent_flagged` = high-importance OR flagged mail. `by_sender` = top 5 senders. Calendar `modified[]` is reserved for future use — modified events surface in `new[]` today (Graph delta doesn't distinguish them). Calendar `organizer_email` is also currently empty (the v1.9.0 delta formatter surfaces the organizer name only).

Mark a To Do task as completed.

Copy a message to another folder (duplicates; source is unchanged). Use outlook_move_message to remove from source. `folder` accepts display names, well-known names, or Graph IDs — prefer names.

Create a new contact with name and optional email, phone, company, job_title, birthday (YYYY-MM-DD). title is the name prefix ("Dr.", "Ms."), shown in the display name — not the job. phone_type: "mobile", "business" or "home".

Create a draft email for later review/send (pair with outlook_send_draft). Use this when a human should review before sending; use outlook_send_message to send immediately without review. reply_to_message_id (reply_all=True for all) or forward_message_id drafts in that thread, quoting the original; on a reply, Graph fills to/cc/subject, so pass [] for a recipient you want cleared and omit the argument to keep Graph's choice. Pass deferred_send_datetime (ISO 8601, e.g. "2026-05-06T08:00:00Z") to schedule delayed delivery — Exchange holds the message server-side after outlook_send_draft. Pass reply_to to pre-populate the Reply-To header.

Create a calendar event with optional attendees, recurrence, busy status, online meeting. Example: outlook_create_event(subject="Q3 review", start="2026-08-15T14:00:00Z", end="2026-08-15T15:00:00Z", attendees=["alice@acme.com"]) `is_online` is accepted but has no effect on personal accounts — Graph silently ignores isOnlineMeeting for consumer mailboxes (it returns isOnlineMeeting: False, onlineMeetingProvider: "unknown"). Teams meetings require a work/school account. `start`/`end` are ISO 8601. Passing `recurrence` creates a series, not a single event. It takes either a shorthand — "daily", "weekdays", "weekly", "monthly", "yearly", all anchored on `start` and open-ended — or a full Microsoft Graph recurrence object for anything else, e.g. every other Mon+Fri for 10 occurrences: {"pattern": {"type": "weekly", "interval": 2, "daysOfWeek": ["monday", "friday"]}, "range": {"type": "numbered", "numberOfOccurrences": 10}} `range.startDate` defaults to the event's start date. Prefer a bounded range ("endDate"/"numbered") when the event has attendees — a "noEnd" series invites them to every future occurrence. `timezone` is the IANA zone the event is anchored in, which is what a recurring series is expanded against (default: the configured zone). A zone name like America/Los_Angeles, never an abbreviation like PDT. `show_as` is Outlook's "Show as": "free", "tentative", "busy", "oof" (out of office), "workingElsewhere", or "unknown". Omitted, Graph defaults the event to busy. `calendar`: name or ID; omit for the default. `key`: your own reference for the event, e.g. a booking number.

Create a mail folder; pass `parent_folder` (name, path or ID) to nest it under that one.

Create a Microsoft To Do task with optional due date, importance, body, and recurrence. Example: outlook_create_task(title="Send invoice", due="2026-09-01", importance="high") `reminder=True` requires `due` and sets the reminder to the due time — Graph silently drops a reminder that has no time. `due` takes ISO 8601 or a relative offset — note `+7d` is seven days from now, while a bare `7d` means seven days *ago*. `importance` is "low", "normal", or "high". Defaults to the user's default list when `list_id` is omitted.

Delete a checklist item from a To Do task.

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; it never replaces an existing file. `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.

Read an event by event_id, or an invitation by message_id (exactly one). Returns your current event: body, attendees with proposed_new_time, organizer, is_organizer, allow_new_time_proposals, is_cancelled, recurrence, type, show_as, key and attachment metadata. start/end are UTC; original_start_time_zone is the anchor zone. recurrence uses the create tool's shape.

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 return only messages with no categories assigned. `after`/`before` take ISO 8601 or a relative offset — `7d` is seven days ago, `+7d` is seven days from now.

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.