Outlook
Microsoft email and calendar.
Verdict
Common use cases
- Draft replies to flagged emails during triage
- Schedule team meetings across time zones
- Attach meeting notes to calendar events
- Look up contact details mid-conversation
- Create follow-up drafts from Slack threads
Integration
- Vendor
- Outlook
- Category
- communication
- Auth
- OAUTH2
- Tools
- 43
- Composio slug
outlook
Tools
- 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 existing event.
- 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 or reference.
- Create a draft reply
Creates a draft reply in the specified user's outlook mailbox to an existing message (identified by a valid `message id`), optionally including a `comment` and cc/bcc recipients.
- Create calendar
Tool to create a new calendar in the signed-in user's mailbox. use when organizing events into a separate calendar.
- Create Calendar Event
Creates a new outlook calendar event, ensuring `start datetime` is chronologically before `end datetime`.
- Create contact
Creates a new contact in a microsoft outlook user's contacts folder.
- Create contact folder
Tool to create a new contact folder in the user's mailbox. use when needing to organize contacts into custom folders.
- Create email draft
Creates an outlook email draft with subject, body, recipients, and an optional attachment. supports creating drafts as part of existing conversation threads by specifying a conversationid; attachments require a name, mimetype, and content.
- Create Email Rule
Create email rule filter with conditions and actions
- Create mail folder
Tool to create a new mail folder. use when you need to organize email into a new folder.
- Create master category
Tool to create a new category in the user's master category list. use after selecting a unique display name.
- Delete Calendar Eventdestructive
Deletes an existing calendar event, identified by its unique `event id`, from a specified user's microsoft outlook calendar, with an option to send cancellation notifications to attendees.
- Delete Contactdestructive
Permanently deletes an existing contact, using its `contact id` (obtainable via 'list user contacts' or 'get contact'), from the outlook contacts of the user specified by `user id`.
- Delete mail folderdestructive
Delete a mail folder from the user's mailbox. use when you need to remove an existing mail folder.
- Download Outlook attachment
Downloads a specific file attachment from an email message in a microsoft outlook mailbox; the attachment must contain 'contentbytes' (binary data) and not be a link or embedded item.
- Get calendar event
Retrieves the full details of a specific calendar event by its id from a user's outlook calendar, provided the event exists.
- Get contact
Retrieves a specific outlook contact by its `contact id` from the contacts of a specified `user id` (defaults to 'me' for the authenticated user).
- 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 browse or select among contact folders.
- Get email message
Retrieves a specific email message by its id from the specified user's outlook mailbox. use the 'select' parameter to include specific fields like 'internetmessageheaders' for filtering automated emails.
- Get mailbox settings
Tool to retrieve mailbox settings. use when you need to view settings such as automatic replies, time zone, and working hours for the signed-in or specified user.
- Get mail delta
Tool to retrieve incremental changes (delta) of messages in a mailbox. use when syncing mailbox updates since last checkpoint.
- Get mail tips
Tool to retrieve mail tips such as automatic replies and mailbox full status. use when you need to check recipient status before sending mail.
- Get master categories
Tool to retrieve the user's master category list. use when you need to get all categories defined for the user.
- Get Outlook profile
Retrieves the microsoft outlook profile for a specified user.
- Get schedule
Retrieves free/busy schedule information for specified email addresses within a defined time window.
- Get supported languages
Tool to retrieve supported languages in the user's mailbox. use when you need to display or select from available mailbox languages.
- 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 choose from for event scheduling.
- 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 attachments.
- List event reminders
Tool to retrieve reminders for events occurring within a specified time range. use when you need to see upcoming reminders between two datetimes.
- List events
Retrieves events from a user's outlook calendar via microsoft graph api, supporting pagination, filtering, property selection, sorting, and timezone specification.
- 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 hidden folders=true to include hidden folders.
- List Messages
Retrieves a list of email messages from a specified mail folder in an outlook mailbox, with options for filtering (including by conversationid to get all messages in a thread), pagination, and sorting; ensure 'user id' and 'folder' are vali
- List Outlook attachments
Lists metadata (like name, size, and type, but not `contentbytes`) for all attachments of a specified outlook email message.
- List Outlook calendars
Tool to list calendars in the signed-in user's mailbox. use when you need to retrieve calendars with optional odata queries.
- List Outlook contacts
Retrieves a user's microsoft outlook contacts, from the default or a specified contact folder.
- Move message to folder
Move a message to another folder within the specified user's mailbox. this creates a new copy of the message in the destination folder and removes the original message.
- Reply to Email
Sends a plain text reply to an outlook email message, identified by `message id`, allowing optional cc and bcc recipients.
- Search Outlook messages
Searches messages in a microsoft 365 or enterprise outlook account mailbox, supporting filters for sender, subject, attachments, pagination, and sorting by relevance or date.
- Send email
Sends an email with subject, body, recipients, and an optional attachment via microsoft graph api; attachments require a non-empty file with valid name and mimetype.
- Update calendar event
Updates specified fields of an existing outlook calendar event.
- Update Contact
Updates an existing outlook contact, identified by `contact id` for the specified `user id`, requiring at least one other field to be modified.
- Update email message
Updates specified properties of an existing email message; `message id` must identify a valid message within the specified `user id`'s mailbox.
- Update mailbox settings
Tool to update mailbox settings for the signed-in user. use when you need to configure automatic replies, default time zone, language, or working hours. example: schedule automatic replies for vacation.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Find Outlook in the MCP directory and click Connect. 3. You'll be redirected to Microsoft's OAuth consent screen — sign in with your work account and approve Mail.ReadWrite, Calendars.ReadWrite, and Contacts.ReadWrite scopes. 4. After granting consent, you'll return to Switchy and see a green checkmark next to Outlook. 5. Open any Space and type '@Outlook list my calendar events for tomorrow' to confirm the connection works. 6. If the MCP returns events, setup is complete; if you see an auth error, revisit Integrations and reconnect.
What teammates see: by default, memories from Outlook are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Draft Reply to Latest
@Outlook find my latest unread email and create a draft reply saying I'll review it by end of week and follow up with any questions.Open in a Space →
Schedule Standup This Week
@Outlook create a daily standup event at 9:00 AM for the next five weekdays, 15 minutes long, titled 'Team Standup'.Open in a Space →
Attach Notes to Meeting
@Outlook find my calendar event titled '1:1 with Alex' today and attach the file 'meeting-notes.pdf' from this Space.Open in a Space →
Lookup Contact by Email
@Outlook look up the contact for alex@example.com and show me their phone number and job title.Open in a Space →
Create Follow-Up Draft
@Outlook create a draft reply to the conversation with subject 'Q4 Budget Review' saying I've reviewed the numbers and will send my feedback by Friday.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Outlook show me all unread emails from the last 3 days that mention 'budget approval' and summarize the key asks
Found 7 unread messages matching your criteria. Three are from Finance requesting Q2 budget sign-off by Friday; two are from the Product team asking for headcount approval to hire a designer; one is from Legal flagging a contract renewal that needs budget allocation; and one is a thread with your VP discussing reallocation of the marketing budget. Most urgent: Finance needs your approval by end-of-week to process vendor payments.
This example shows Outlook's search and filtering paired with AI synthesis. The MCP can query messages by date, read status, and content, then the AI summarizes themes. Requires Mail.Read scope. Note that large result sets may hit token limits—narrow your time window if responses truncate.
@Outlook create a calendar event for 'Q1 Planning Review' next Tuesday 2-3:30pm, invite alice@company.com and bob@company.com, and attach the latest planning doc from my OneDrive
Created event 'Q1 Planning Review' on Tuesday, January 14, 2025, 2:00 PM – 3:30 PM (Pacific Time). Invitations sent to alice@company.com and bob@company.com. Attached 'Q1_Planning_Draft_v3.docx' (1.2 MB) from your OneDrive. Event ID: AAMkAGZjOTNkYzQyLTk4M... You can view or edit it in Outlook.
Demonstrates event creation with attendees and file attachments in one prompt. The MCP handles timezone inference from your mailbox settings. Attachments must be under 3 MB; larger files should be shared via link. Requires Calendars.ReadWrite and Files.Read (if pulling from OneDrive). Side-effect: invitations are sent immediately.
@Outlook draft a reply to the last email from sarah@vendor.com thanking her for the proposal and asking for a revised timeline, cc my manager
Draft reply created in your Outlook mailbox. Subject: 'Re: Q1 Vendor Proposal'. Body includes your thank-you note and request for a revised delivery timeline. CC'd manager@company.com. The draft is saved but not sent—you can review and edit it in Outlook before sending. Message ID: AAMkAGZjOTNkYzQyLTk4M...
Shows the MCP's ability to create contextual draft replies without sending. The AI composes tone-appropriate language; you retain final control. Requires Mail.ReadWrite scope. The MCP identifies the most recent message from the sender—if there are multiple threads, specify more context (subject line or date) to avoid ambiguity.
Use-case deep-dives
When Outlook MCP beats manual email threading for client work
A 3-person consulting team prepping for a client kickoff needs to draft a meeting invite, attach the SOW, and loop in stakeholders without leaving their AI workspace. The Outlook MCP handles this in one pass: create the calendar event, add the attachment via event ID, and draft a follow-up email referencing the same conversation thread. This works because the MCP exposes both calendar and mail tools with OAuth2 scope to read/write across mailboxes. The threshold: if your team sends more than 10 client-facing emails per week that require attachments or calendar coordination, this MCP saves 15-20 minutes per cycle. If you're just scheduling internal standups, the calendar-only scope is overkill—use a lighter integration.
Outlook MCP for high-volume customer email routing
A 5-person support team triaging 200+ inbound emails daily needs to draft replies, tag threads, and route escalations without switching between Outlook and their ticketing system. The Outlook MCP's draft-reply and conversation-threading tools let the AI read a message, generate a response, and queue it for human review—all in Switchy. The 43-tool count matters here: you get contact lookup, folder creation, and attachment handling in the same scope, so the AI can file a customer's follow-up into a custom folder while drafting the reply. This breaks down if your team uses shared mailboxes heavily—OAuth2 per-user auth means each agent needs their own token. For teams under 10 people with individual inboxes, this is the fastest way to cut email response time in half.
When Outlook MCP replaces spreadsheet-based candidate tracking
A 2-person recruiting team managing 30 active candidates needs to schedule interviews, track email threads, and store resumes without a full ATS. The Outlook MCP's contact-creation and folder-organization tools turn Outlook into a lightweight CRM: the AI creates a contact per candidate, files their resume as an attachment, and drafts interview invites with calendar blocks. The representative tools (create contact, create contact folder, add mail attachment) map directly to this workflow. The limit: if you're hiring for more than 5 roles simultaneously, the lack of pipeline-stage tracking in Outlook means you'll outgrow this setup in 8-10 weeks. For early-stage teams closing 1-2 hires per quarter, this MCP eliminates the need for a separate recruiting tool and keeps everything in the inbox your team already checks.
Frequently asked
What can the Outlook MCP do in Switchy?
The Outlook MCP lets AI agents read, send, and draft emails; create and manage calendar events with attachments; and organise contacts into folders. It's built for teams that want AI to handle routine Outlook tasks — scheduling meetings, triaging inbox threads, or prepping draft replies — without switching between apps or copy-pasting data.
Which OAuth scopes does the Outlook MCP request?
The MCP requests Mail.ReadWrite (to read and send messages), Calendars.ReadWrite (to create and edit events), and Contacts.ReadWrite (to manage your address book). You'll authenticate once via Microsoft's OAuth flow; Switchy stores the token and refreshes it automatically. No admin consent needed unless your IT team enforces tenant-wide app approval.
Can the Outlook MCP send emails on my behalf?
Yes. It can create drafts, send messages immediately, and reply to existing threads with optional CC or BCC recipients. Attachments under 3 MB work inline; larger files need a separate upload step. The MCP uses your authenticated account, so sent mail appears in your Sent Items folder and matches your usual signature settings.
How does this compare to using Outlook's web app or Graph API directly?
The MCP wraps Microsoft Graph into natural-language tools, so your team describes what they want instead of writing API calls or clicking through menus. You lose some advanced features — shared mailboxes, retention policies, custom forms — but gain speed for repetitive tasks like scheduling across time zones or bulk-drafting follow-ups based on CRM data.
Who on the team should connect the Outlook MCP?
Anyone whose calendar, inbox, or contacts the AI needs to touch. Each connection is scoped to one Microsoft account, so if three people want AI-assisted scheduling, all three authenticate separately. Connections don't count against Switchy seat limits, but each user must have an active Microsoft 365 license with the mailbox features you're automating.