# Microsoft Outlook

The Microsoft Graph Outlook API enables access to Microsoft Outlook data including emails, folders, contacts, and mail settings. This integration allows reading and managing Outlook content on behalf of the user.

- Category: Communication
- Connection: Sign in. Sign in with your Microsoft Outlook account. No API key to copy.
- Plans: Free: Not included; MCP only ($9/mo): 2,000 calls a month; Pro: 20,000 calls a month; Max: 20,000 calls a month
- Consent: Sending consent (https://krypton.bot/terms/#publishing). Before Microsoft Outlook connects, you confirm the sending consent: your bots send and move messages as you, and you are the sender of every message.
- Status: coming soon

## Tools

- Create child folder (`MICROSOFT_OUTLOOK__CREATE_CHILD_FOLDER`): Create a new child mail folder under a specific parent folder. You can set the folder name and whether it should be hidden. Hidden folders cannot be unhidden later. This is useful for organizing emails in a hierarchical structure.
- Create draft message (`MICROSOFT_OUTLOOK__CREATE_DRAFT_MESSAGE`): Create a draft of a new message in JSON format. By default, this operation saves the draft in the Drafts folder. You can update the draft later to add content or change properties, or send it in a subsequent operation.
- Create forward (`MICROSOFT_OUTLOOK__CREATE_FORWARD`): Create a draft to forward an existing message. You can optionally add a comment and specify recipients. The draft can be updated later or sent in a subsequent operation.
- Create mail folder (`MICROSOFT_OUTLOOK__CREATE_MAIL_FOLDER`): Create a new mail folder in the root folder of the user's mailbox. You can set the folder name and whether it should be hidden. Hidden folders cannot be unhidden later.
- Create message in folder (`MICROSOFT_OUTLOOK__CREATE_MESSAGE_IN_FOLDER`): Create a new message directly in a specific mail folder. This creates an actual message in the folder, not a draft. The message will appear in the specified folder immediately.
- Create reply (`MICROSOFT_OUTLOOK__CREATE_REPLY`): Create a draft reply to an existing message. The reply will automatically include the original sender as the recipient and reference the original message.
- Create reply all (`MICROSOFT_OUTLOOK__CREATE_REPLY_ALL`): Create a draft to reply to the sender and all recipients of a message. The reply will automatically include all original recipients (To, CC) and follow proper reply-to logic.
- List child folders (`MICROSOFT_OUTLOOK__LIST_CHILD_FOLDERS`): Get the collection of child folders under a specified mail folder. By default, hidden folders are excluded unless explicitly requested. Supports OData query parameters for filtering and customization.
- List mail folders (`MICROSOFT_OUTLOOK__LIST_MAIL_FOLDERS`): Get the mail folder collection directly under the root folder of the signed-in user. Includes mail search folders and can optionally include hidden folders.
- List messages (`MICROSOFT_OUTLOOK__LIST_MESSAGES`): List email messages from the user's inbox.
- List messages in folder (`MICROSOFT_OUTLOOK__LIST_MESSAGES_IN_FOLDER`): Get all messages in a specified mail folder. Supports filtering, pagination, and sorting using OData query parameters. This allows you to retrieve messages from any specific folder in the mailbox.
- Copy mail folder (`MICROSOFT_OUTLOOK__COPY_MAIL_FOLDER`): Copy a mail folder and its contents to another mail folder. You can specify a destination folder ID or use well-known folder names like 'inbox', 'drafts', 'sentitems', 'deleteditems'. The entire folder structure and contents will be duplicated.
- Copy message (`MICROSOFT_OUTLOOK__COPY_MESSAGE`): Copy a message to a folder within the user's mailbox. You can specify a destination folder ID or use well-known folder names like 'inbox', 'drafts', 'sentitems', 'deleteditems'.
- Delete mail folder (`MICROSOFT_OUTLOOK__DELETE_MAIL_FOLDER`): Delete a mail folder by its ID. The folder can be a mailSearchFolder. You can specify a mail folder by its folder ID, or by its well-known folder name. Note: You may not be able to delete items in the recoverable items deletions folder.
- Delete message (`MICROSOFT_OUTLOOK__DELETE_MESSAGE`): Delete a specific email message by its ID. This operation moves the message to the Deleted Items folder.
- Get mail folder (`MICROSOFT_OUTLOOK__GET_MAIL_FOLDER`): Retrieve the properties and relationships of a specific mail folder object by its ID. Returns detailed folder information including permissions and relationships.
- Get message (`MICROSOFT_OUTLOOK__GET_MESSAGE`): Get a specific email message by its ID with detailed information including sender, recipients, subject, body, and attachments.
- Reply (`MICROSOFT_OUTLOOK__REPLY`): Reply to the sender of a message immediately (not as draft). The reply will be sent right away and saved in the Sent Items folder. You can add a comment or custom body.
- Reply all (`MICROSOFT_OUTLOOK__REPLY_ALL`): Reply to all recipients of a message immediately (not as draft). The reply will be sent right away to all original recipients and saved in the Sent Items folder. You can add a comment or custom body.
- Delta mail folders (`MICROSOFT_OUTLOOK__DELTA_MAIL_FOLDERS`): Get incremental changes (added, deleted, or updated) in mail folders since the last delta query. This allows efficient synchronization by tracking only changes rather than fetching all folders every time. Use deltatoken for completed rounds and skiptoken for pagination.
- Forward (`MICROSOFT_OUTLOOK__FORWARD`): Forward a message immediately (not as draft). The message will be sent right away and saved in the Sent Items folder. You can add a comment and specify recipients.
- Permanent delete (`MICROSOFT_OUTLOOK__PERMANENT_DELETE`): Permanently delete a message and place it in the purges folder in the dumpster. Unlike regular delete, this cannot be recovered by email clients and items are permanently deleted after a set period.
- Send (`MICROSOFT_OUTLOOK__SEND`): Send an existing draft message. The draft can be a new message draft, reply draft, reply-all draft, or forward draft. This saves the message in the Sent Items folder.
- Update mail folder (`MICROSOFT_OUTLOOK__UPDATE_MAIL_FOLDER`): Update the properties of a mail folder object. Currently supports updating the display name of the folder. This allows you to rename folders for better organization.

## Questions

### When can I connect Microsoft Outlook?

Microsoft Outlook is coming soon and cannot be connected yet. Browse the catalog for apps you can connect now.

### Which plan includes Microsoft Outlook?

MCP only with 2,000 calls a month, Pro and Max with 20,000. Calls are shared by every catalog app in the workspace. Past the monthly number they keep working from AI credits at $0.90 per 1,000 calls; the count resets on the 1st (UTC) and a retried call counts once.

Back to the [MCP catalog](https://krypton.bot/mcp-catalog/).
