Skip to main content
Glama
new-outlook-mcp

new-outlook-mcp

by michalhron

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_emailsA

Search archived emails. Returns summaries with an id for get_email/get_thread. freshness says how current the archive is. If warning is present the archive may be missing newer mail: tell the user.

semantic_searchA

Find emails and attachments by meaning. Each result is one email with the best matching passage as its snippet, match says whether that passage is the subject, the body or an attachment, and matched says whether meaning, keywords or both found it.

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. freshness and warning work as in search_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 attachment_id ('orphan:'). Dates are file dates, not send dates. Use search_emails for mail itself.

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. route says how it was opened and attachments_in_draft whether the files really are in it. If that is false, tell the user to drag them in from Finder.

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 (in_thread is false), because Outlook offers no way to reply to a recent message by script: tell the user.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.3/5.0

Scored across 22 tools

Disambiguation4/5

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.

Naming Consistency3/5

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).

Tool Count4/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues