Skip to main content

Context Sources

Outlook Mail

Outlook Mail

Connect Outlook Mail to search Microsoft 365 correspondence and prepare replies.

What it can do​

  • List folders, and search and read messages.
  • List attachments, and save one to the chat's files to open, search, or work with.
  • Create and update drafts, including draft replies.
  • Mark messages read or unread, flag, categorize, move, or delete them.

Setup and security​

  • You sign in with your own Microsoft account. Nomic can reach only that mailbox.
  • Tools that change data ask for approval before they run. The Approval column under Supported tools shows each tool's setting.
  • Nomic cannot send, forward, or reply to messages directly. Drafts stay in Outlook until you send them.
  • Your Microsoft 365 administrator may need to approve Nomic before you can finish signing in. See Microsoft Graph permissions.
  • Outlook Mail and Outlook Calendar are separate sign-ins. Both are separate from the Outlook integration under Settings → Integrations.

To connect, see Add an MCP server.

Example requests​

  • "Find emails from the owner's rep about the lobby finishes and summarize the decisions."
  • "Draft a reply to the contractor's latest schedule email using the dates we just confirmed."
  • "Which messages in my inbox this week mention the Riverside permit?"
  • "Move all messages from the tile supplier into the Riverside folder."

Supported tools​

ToolActionApproval
get_meRead the signed-in Microsoft profile.Not required
list_mail_foldersList mail folders.Not required
list_messagesList messages in a folder.Not required
search_messagesSearch mail.Not required
get_messageRead a message.Not required
list_attachmentsList attachment names, types, and sizes.Not required
get_attachmentSave an attachment to the chat's files.Not required
create_draftCreate an email draft.Required
update_draftChange an existing draft.Required
create_reply_draftCreate a draft reply to a message.Required
update_messageChange read status, flag, importance, or categories.Required
move_messageMove a message to another folder.Required
delete_messageDelete a message.Required

Microsoft Graph permissions​

This section is for Microsoft 365 administrators reviewing Nomic in Microsoft Entra.

Outlook Mail requests only delegated permissions. Nomic acts as the signed-in user and reaches only that user's mailbox. It requests no application permissions, so it cannot read other mailboxes or run without a signed-in user.

PermissionTypeAdmin consentUsed for
offline_accessDelegatedNot requiredKeep the user signed in between sessions with a refresh token.
User.ReadDelegatedNot requiredRead the signed-in user's profile.
Mail.ReadWriteDelegatedNot requiredRead mail and attachments, manage drafts, and organize mail.

Microsoft does not require admin consent for these permissions, but your tenant's user consent settings may still require an administrator to approve Nomic.

Nomic does not request Mail.Send, so it cannot send, reply to, or forward mail.

Outlook Mail, Outlook Calendar, and Microsoft Teams sign in through the same Nomic app in Microsoft Entra. Each requests only its own permissions when a user signs in.

Graph API calls​

Every call goes to https://graph.microsoft.com/v1.0 and stays under /me. get_me uses User.Read; every other tool uses Mail.ReadWrite.

ToolGraph API call
get_meGET /me
list_mail_foldersGET /me/mailFolders
list_messages, search_messagesGET /me/messages
GET /me/mailFolders/{id}/messages
get_messageGET /me/messages/{id}
list_attachmentsGET /me/messages/{id}/attachments
get_attachmentGET /me/messages/{id}/attachments/{id}
GET /me/messages/{id}/attachments/{id}/$value
create_draftPOST /me/messages
create_reply_draftPOST /me/messages/{id}/createReply
POST /me/messages/{id}/createReplyAll
update_draft, update_messagePATCH /me/messages/{id}
move_messagePOST /me/messages/{id}/move
delete_messageDELETE /me/messages/{id}