outlook
Work with the user's Outlook mailbox, calendar, contacts and tasks through the outlook MCP server. Use for reading or triaging email, drafting and sending, replying, scheduling meetings, finding free
SKILL.mdskills/outlook/SKILL.md
GitHubOutlook
Tools come from the outlook MCP server (Outlook desktop on Windows). Keep calls cheap: list first, read only what you need.
Token-lean workflow
mail_listreturns one line per message. Narrow it withquery,from,since,unreadinstead of paging through everything. Leavepreviewat 0 unless you must triage by content.- Read with
mail_get. Bodies are cleaned and capped; passbody_offsetfor the rest. Ask forheaders=trueonly when you need addresses or routing info. - Act in batches:
mail_update,mail_moveandmail_deletetake many ids in one call. - For long threads use
mail_thread(trimmed bodies) instead of reading each message.
Sending safely
- Default to a draft:
mail_draft_save,mail_reply,mail_forwardsave drafts unlesssend=true. - Only
mail_send,mail_draft_sendorsend=trueactually send. Do that only when the user said to send, and after they have seen the recipients and text. - With several accounts, call
statusonce, then passaccount. If Outlook cannot honour it the tool fails without sending. - Never invent addresses. Resolve names with
recipient_resolveorcontacts_search. - No signature is added automatically; include it in the body if the user wants one.
Calendar
calendar_eventsfor a date range (recurring meetings are expanded).calendar_free_busyto find slots, optionally across attendees.calendar_event_createwith attendees saves an unsent meeting unlesssend_invites=true.- Edit or delete one occurrence of a recurring event by passing
occurrence_start. calendar_respondaccepts, tentatively accepts or declines a meeting request (message id from the inbox).
Contacts and tasks
contacts_search,contact_get,contact_save,recipient_resolve(also searches the company address list on Exchange).tasks_list,task_save(create, edit, complete),task_delete.
Limits worth knowing
- Classic Outlook only; the new Outlook for Windows has no COM interface.
- Out-of-office, mail rules and signatures are not exposed by Outlook's object model.
- Dates are local time. Use ISO 8601 (
2026-10-30T14:00).