Skip to main content
Glama
desek

outlook-local-mcp

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
OUTLOOK_MCP_CLIENT_IDNoMicrosoft Entra ID application (client) ID, or a well-known alias such as outlook-desktop. Defaults to outlook-desktop.
OUTLOOK_MCP_READ_ONLYNoSet to true to block all write operations server-side.
OUTLOOK_MCP_TENANT_IDNoMicrosoft Entra ID tenant ID, or 'common' for multi-tenant sign-in. Defaults to common.
OUTLOOK_MCP_AUTH_METHODNoAuthentication method: browser, device_code, or auth_code. Containers should use device_code.
OUTLOOK_MCP_MAIL_ENABLEDNoSet to true to register mail read verbs. Disabled by default.
OUTLOOK_MCP_MAIL_MANAGE_ENABLEDNoSet to true to register mail draft and management verbs. Implies MAIL_ENABLED.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{}
logging
{}
resources
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
accountA

Account management for Microsoft accounts connected to the Outlook MCP server.

Set the required operation parameter to one of the verbs below. Each line names the verb, what it does, and the parameters that verb requires. Optional parameters are omitted here; call operation="help" for the full parameter reference.

  • help: show detailed documentation for all verbs or a single named verb. No required parameters.

  • add: add and authenticate a new Microsoft account (browser/device_code/auth_code). Requires: label.

  • remove: remove an account from the registry and clear its tokens (irreversible). Requires: label.

  • list: list all registered accounts with label, UPN, state, and auth_method. No required parameters.

  • login: re-authenticate a disconnected account without removing it. Requires: label.

  • logout: disconnect an account without removing it; preserves config for login. Requires: label.

  • refresh: force a token refresh for an authenticated account; returns new expiry. Requires: label.

calendarA

Calendar operations for Microsoft Outlook via Microsoft Graph.

Set the required operation parameter to one of the verbs below. Each line names the verb, what it does, and the parameters that verb requires. Optional parameters are omitted here; call operation="help" for the full parameter reference.

  • help: show detailed documentation for all verbs or a single named verb. No required parameters.

  • list_calendars: list all calendars accessible to the authenticated user. No required parameters.

  • list_events: list events in a time window; expands recurring events into occurrences. No required parameters.

  • get_event: get full event details by ID; bodyPreview by default, full body via output=raw. Requires: event_id.

  • search_events: search events by subject, date range, importance, sensitivity, and other filters. No required parameters.

  • create_event: create a personal calendar event (no attendees); use create_meeting for meetings. Requires: subject, start_datetime.

  • update_event: update a personal event (PATCH); use update_meeting to change attendees. Requires: event_id.

  • delete_event: permanently delete an event by ID (organizer deletions notify attendees). Requires: event_id.

  • respond_event: accept, tentatively accept, or decline an invitation; notifies organizer. Requires: event_id, response.

  • reschedule_event: move a personal event to a new start time, preserving its original duration. Requires: event_id, new_start_datetime.

  • create_meeting: create a meeting with attendees; sends invitations; confirm with user first. Requires: subject, start_datetime, attendees.

  • update_meeting: update a meeting including attendee changes; sends notifications; confirm first. Requires: event_id.

  • cancel_meeting: cancel a meeting and notify attendees; organizer only; confirm with user first. Requires: event_id.

  • reschedule_meeting: move a meeting to a new start time, preserving duration; notifies attendees. Requires: event_id, new_start_datetime.

  • get_free_busy: get free/busy availability for a time range; returns busy periods with times. No required parameters.

mailA

Mail operations for Microsoft Outlook via Microsoft Graph. By default only read verbs are registered. Additional read verbs (get_conversation, list_attachments, get_attachment) are registered when MailEnabled is configured, and write verbs (create_draft, create_reply_draft, create_forward_draft, update_draft, delete_draft) are registered when MailManageEnabled is configured. The verbs listed below are those active in the current configuration.

Set the required operation parameter to one of the verbs below. Each line names the verb, what it does, and the parameters that verb requires. Optional parameters are omitted here; call operation="help" for the full parameter reference.

  • help: show detailed documentation for all verbs or a single named verb. No required parameters.

  • list_folders: list mail folders (Inbox, Sent, Drafts, etc.) with unread and total counts. No required parameters.

  • list_messages: list messages in a folder or across all folders; filter by date, sender, thread. No required parameters.

  • get_message: get full message details by ID; bodyPreview by default, full body via output=raw. Requires: message_id.

  • search_messages: full-text KQL search across messages; ranked by relevance, not chronologically. Requires: query.

systemA

System diagnostics and authentication utilities for the Outlook MCP server. Start with system.about when troubleshooting; it returns build identity and host environment metadata without requiring authentication.

Set the required operation parameter to one of the verbs below. Each line names the verb, what it does, and the parameters that verb requires. Optional parameters are omitted here; call operation="help" for the full parameter reference.

  • help: show detailed documentation for all verbs or a single named verb. No required parameters.

  • about: return build identity and host environment metadata for troubleshooting. No required parameters.

  • status: return server health: version, accounts, uptime, config (no Graph call). No required parameters.

  • list_docs: list embedded documentation: slug, title, summary, tags, size, and doc:// URI. No required parameters.

  • search_docs: search embedded docs by keyword; returns ranked snippets with line numbers. Requires: query.

  • get_docs: fetch a document or section by slug; use search_docs first to identify the slug. Requires: slug.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
ConceptsCore concepts: output tiers, multi-account model, auto-default account, MCP elicitation, read-only mode, mail gating, headless auth, OAuth scopes, well-known client IDs, in-server docs, and observability.
Quick Start GuideStep-by-step setup: prerequisites, installation, authentication, and first tool call.
READMEProject overview, install pointer, supported features, and links to further documentation.
Troubleshooting GuideCommon failure modes and remediation steps: auth errors, Graph throttling, mail flags, Keychain, and account lifecycle.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/desek/outlook-local-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server