# Outlook (verified) Read and send emails, manage calendar events, and organize contacts. Search messages, handle attachments, and schedule meetings. ## Quick Start ```bash # Connect this server (installs CLI if needed) npx -y @smithery/cli@latest mcp add outlook # Browse available tools npx -y @smithery/cli@latest tool list outlook # Get full schema for a tool npx -y @smithery/cli@latest tool get outlook OUTLOOK_ADD_EVENT_ATTACHMENT # Call a tool npx -y @smithery/cli@latest tool call outlook OUTLOOK_ADD_EVENT_ATTACHMENT '{}' ``` ## Direct MCP Connection Endpoint: `https://outlook.run.tools` ## Tools (51) - `OUTLOOK_ADD_EVENT_ATTACHMENT` — Adds an attachment to a specific Outlook calendar event. Use when you need to attach a file or nested item to an existi… - `OUTLOOK_ADD_MAIL_ATTACHMENT` — Tool to add an attachment to an email message. Use when you have a message ID and need to attach a small (<3 MB) file o… - `OUTLOOK_CALENDAR_CREATE_EVENT` — Creates a new Outlook calendar event, ensuring `start_datetime` is chronologically before `end_datetime`. - `OUTLOOK_CREATE_ATTACHMENT_UPLOAD_SESSION` — Tool to create an upload session for large (>3 MB) message attachments. Use when you need to upload attachments in chun… - `OUTLOOK_CREATE_CALENDAR` — Tool to create a new calendar in the signed-in user's mailbox. Use when organizing events into a separate calendar. - `OUTLOOK_CREATE_CONTACT` — Creates a new contact in a Microsoft Outlook user's contacts folder. - `OUTLOOK_CREATE_CONTACT_FOLDER` — Tool to create a new contact folder in the user's mailbox. Use when needing to organize contacts into custom folders. - `OUTLOOK_CREATE_DRAFT` — Creates an Outlook email draft with subject, body, recipients, and an optional attachment. Supports creating drafts as … - `OUTLOOK_CREATE_DRAFT_REPLY` — Creates a draft reply in the specified user's Outlook mailbox to an existing message (identified by a valid `message_id… - `OUTLOOK_CREATE_EMAIL_RULE` — Create email rule filter with conditions and actions - `OUTLOOK_CREATE_MAIL_FOLDER` — Tool to create a new mail folder. Use when you need to organize email into a new folder. - `OUTLOOK_CREATE_MASTER_CATEGORY` — Tool to create a new category in the user's master category list. Use after selecting a unique display name. - `OUTLOOK_DELETE_CONTACT` — Permanently deletes an existing contact, using its `contact_id` (obtainable via 'List User Contacts' or 'Get Contact'),… - `OUTLOOK_DELETE_EMAIL_RULE` — Delete an email rule - `OUTLOOK_DELETE_EVENT` — Deletes an existing calendar event, identified by its unique `event_id`, from a specified user's Microsoft Outlook cale… - `OUTLOOK_DELETE_MAIL_FOLDER` — Delete a mail folder from the user's mailbox. Use when you need to remove an existing mail folder. - `OUTLOOK_DOWNLOAD_OUTLOOK_ATTACHMENT` — Downloads a specific file attachment from an email message in a Microsoft Outlook mailbox; the attachment must contain … - `OUTLOOK_GET_CALENDAR_VIEW` — Get events ACTIVE during a time window (includes multi-day events). Use for "what's on my calendar today/this week" or … - `OUTLOOK_GET_CONTACT` — Retrieves a specific Outlook contact by its `contact_id` from the contacts of a specified `user_id` (defaults to 'me' f… - `OUTLOOK_GET_CONTACT_FOLDERS` — Tool to retrieve a list of contact folders in the signed-in user's mailbox. Use after authentication when you need to b… - `OUTLOOK_GET_EVENT` — Retrieves the full details of a specific calendar event by its ID from a user's Outlook calendar, provided the event ex… - `OUTLOOK_GET_MAILBOX_SETTINGS` — Tool to retrieve mailbox settings. Use when you need to view settings such as automatic replies, time zone, and working… - `OUTLOOK_GET_MAIL_DELTA` — Retrieve incremental changes (delta) of messages in a mailbox. FIRST RUN: Returns ALL messages in folder (use top=50 to… - `OUTLOOK_GET_MAIL_TIPS` — Tool to retrieve mail tips such as automatic replies and mailbox full status. Use when you need to check recipient stat… - `OUTLOOK_GET_MASTER_CATEGORIES` — Tool to retrieve the user's master category list. Use when you need to get all categories defined for the user. - `OUTLOOK_GET_MESSAGE` — Retrieves a specific email message by its ID from the specified user's Outlook mailbox. Use the 'select' parameter to i… - `OUTLOOK_GET_PROFILE` — Retrieves the Microsoft Outlook profile for a specified user. - `OUTLOOK_GET_SCHEDULE` — Retrieves free/busy schedule information for specified email addresses within a defined time window. - `OUTLOOK_GET_SUPPORTED_LANGUAGES` — Tool to retrieve supported languages in the user's mailbox. Use when you need to display or select from available mailb… - `OUTLOOK_GET_SUPPORTED_TIME_ZONES` — Tool to retrieve supported time zones in the user's mailbox. Use when you need a list of time zones to display or choos… - `OUTLOOK_LIST_CALENDARS` — Tool to list calendars in the signed-in user's mailbox. Use when you need to retrieve calendars with optional OData que… - `OUTLOOK_LIST_CONTACTS` — Retrieves a user's Microsoft Outlook contacts, from the default or a specified contact folder. - `OUTLOOK_LIST_EMAIL_RULES` — List all email rules from inbox - `OUTLOOK_LIST_EVENT_ATTACHMENTS` — Tool to list attachments for a specific Outlook calendar event. Use when you have an event ID and need to view its atta… - `OUTLOOK_LIST_EVENTS` — Retrieves events from a user's Outlook calendar via Microsoft Graph API. Supports primary/secondary/shared calendars, p… - `OUTLOOK_LIST_MAIL_FOLDERS` — Tool to list a user's top-level mail folders. Use when you need folders like Inbox, Drafts, Sent Items; set include_hid… - `OUTLOOK_LIST_MESSAGES` — Retrieves a list of email messages from a specified mail folder in an Outlook mailbox, with options for filtering (incl… - `OUTLOOK_LIST_OUTLOOK_ATTACHMENTS` — Lists metadata (like name, size, and type, but not `contentBytes`) for all attachments of a specified Outlook email mes… - `OUTLOOK_LIST_REMINDERS` — Tool to retrieve reminders for events occurring within a specified time range. Use when you need to see upcoming remind… - `OUTLOOK_LIST_USERS` — Tool to list users in Microsoft Entra ID. Use when you need to retrieve a paginated list of users, optionally filtering… - `OUTLOOK_MOVE_MESSAGE` — Move a message to another folder within the specified user's mailbox. This creates a new copy of the message in the des… - `OUTLOOK_QUERY_EMAILS` — Primary tool for querying Outlook emails with custom OData filters. Build precise server-side filters for dates, read s… - `OUTLOOK_REPLY_EMAIL` — Sends a plain text reply to an Outlook email message, identified by `message_id`, allowing optional CC and BCC recipien… - `OUTLOOK_SEARCH_MESSAGES` — Search Outlook messages using powerful KQL syntax. Supports sender (from:), recipient (to:, cc:), subject, date filters… - `OUTLOOK_SEND_DRAFT` — Tool to send an existing draft message. Use after creating a draft when you want to deliver it to recipients immediatel… - `OUTLOOK_SEND_EMAIL` — Sends an email with subject, body, recipients, and an optional attachment via Microsoft Graph API. Supports comma-separ… - `OUTLOOK_UPDATE_CALENDAR_EVENT` — Updates specified fields of an existing Outlook calendar event. Implementation note: To avoid unintentionally clearing … - `OUTLOOK_UPDATE_CONTACT` — Updates an existing Outlook contact, identified by `contact_id` for the specified `user_id`, requiring at least one oth… - `OUTLOOK_UPDATE_EMAIL` — Updates specified properties of an existing email message; `message_id` must identify a valid message within the specif… - `OUTLOOK_UPDATE_EMAIL_RULE` — Update an existing email rule - `OUTLOOK_UPDATE_MAILBOX_SETTINGS` — Tool to update mailbox settings for the signed-in user. Use when you need to configure automatic replies, default time … ```bash # Get full input/output schema for a tool npx -y @smithery/cli@latest tool get outlook ```