new-outlook-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Local, read-only archive of the user's Outlook for Mac mail and calendar: the
frozen legacy Outlook archive, the New Outlook cache, and optional published
ICS feeds. Search with search_emails, then open a message with get_email (use
its id). Bodies are plain text and may be truncated: pass offset =
next_offset to continue. search_files finds attachment files and bodies in Outlook's
cache that no archived message owns. Calendar tools work on the user's own calendar only.
A result with a warning field may be missing newer mail: tell the user, do not
treat an empty result as proof that a message does not exist.
Nothing here can send mail, answer invitations, or change calendar events.
create_draft, create_reply_draft and create_event_draft only open a draft that the user reviews
and sends or saves themselves.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_emailsA | Search archived emails. Returns summaries with an |
| semantic_searchA | Find emails and attachments by meaning. Each result is one email with the best matching passage as
its |
| find_similarB | Find emails similar in content to an email or to one attachment. Give exactly one of the two ids. |
| get_emailA | Get one email: metadata, attachment list and plain-text body (paged with offset). |
| get_threadA | Get the conversation containing a message, oldest first. Uses Message-ID/References/In-Reply-To, the Outlook conversation id, and falls back to the normalized subject. |
| list_recentC | List the newest archived emails. |
| list_attachmentsA | List an email's attachments: name, type, size, and whether the file is on this Mac. |
| get_attachmentA | Read an attachment from local storage. Never downloads from a server: if the file is not on this Mac, the result says so. Ids like 'orphan:12' are files that no archived message owns: their text stays available even after Outlook deletes the file. |
| search_filesA | Search files in Outlook's Files/ cache that belong to no archived message (attachments and bodies
of mail that has left the cache). Read one with get_attachment using its |
| list_calendar_eventsB | List calendar event occurrences in a date range (recurring events are expanded). |
| get_calendar_eventA | Full details of one event: times, attendees and responses, body, meeting link, recurrence. |
| search_calendarC | Search calendar events. |
| calendar_freebusyB | My own busy blocks and free time within working hours. Other people's calendars are not available. |
| find_free_slotsC | Find free slots of a given length in my own calendar. |
| meeting_prepB | Prepare for a meeting: event details, attendees, and recent email threads with them or on the topic. |
| create_event_draftA | EXPERIMENTAL. Open a new-event draft (.ics) in Outlook for the user to review and save. It does not add, change or delete anything in the calendar and sends no invitations. |
| list_foldersA | List folders with message counts and date ranges. |
| archive_statusB | Archive size, date coverage per source (legacy, hxstore) and the last sync per source. |
| diagnoseA | Run when sync fails, results look stale or a tool errors: checks whether this server may read Outlook's files, whether the cache layout matches the decoder, archive age and the sync agents. Each problem comes with a fix to pass on to the user. |
| sync_nowA | Import new mail and calendar data from local Outlook files into the archive. Reads copies of Outlook's files only. The one network access is the user's own published ICS feeds, if configured. |
| create_draftA | Open a prefilled draft in Outlook, even if another app is the default mail app. It never sends: the
user reviews and sends the draft manually. |
| create_reply_draftA | Open a draft answering an archived email, with recipients, Re: subject and the original quoted. It
never sends: the user reviews and sends it. It is a new message, not linked to the thread ( |
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 22 tools
Most tools have clearly distinct scopes: get_email/get_thread/list_attachments are reads of different resources, and semantic_search vs search_emails is disambiguated by 'by meaning' vs 'archived keyword search'. Minor overlap remains between semantic_search and find_similar, and between calendar_freebusy and find_free_slots, which an agent could confuse without careful reading.
The dominant verb_noun pattern (list_attachments, create_reply_draft, search_calendar) is common, but several tools break it with noun-first or noun-only names like calendar_freebusy, meeting_prep, archive_status and diagnose. Also, get_email vs get_calendar_event use different subject-naming conventions (bare noun versus domain-prefixed).
22 tools cover a broad domain (email, attachments, calendar, sync, diagnostics), and each appears to address a real workflow step. It is slightly heavy and could be trimmed by consolidating overlapping free/busy tools, but it is not excessive for the scope.
The read surface is thorough: search, retrieval, threads, attachments, orphan files, calendar, folders, sync status and diagnostics are all covered, with draft-based write operations. Gaps are mostly intentional (no send, no update/delete/move of mail or calendar events), which limits agents to read-plus-draft workflows.