Nodal-Agents
ReferenceConnectors

Outlook Mail

Outlook Mail connector — OAuth flow — uses your Microsoft credential (create one under Credentials).

Auth: OAuth 2.0 (credential type microsoft-oauth)

Slug: outlook-mail

Setup: OAuth flow — uses your Microsoft credential (create one under Credentials).

Access requested

OAuth scopes:

  • offline_access
  • openid
  • email
  • profile
  • https://graph.microsoft.com/Mail.ReadWrite
  • https://graph.microsoft.com/Mail.Send
  • https://graph.microsoft.com/MailboxSettings.Read

Destructive operations (delete, overwrite) can be disabled per-agent: in the agent's Connectors tab, the "enabled operations" allowlist controls exactly which of the tools below an agent may call. Operations marked Destructive below are the ones to review first.

Tools (15)

Read (5)

ToolOperationDescription
outlook_list_messagesList messagesSearch and list Outlook emails, optionally scoped to a folder.
outlook_get_messageGet messageRetrieve a single Outlook email by ID.
outlook_list_draftsList draftsList Outlook email drafts.
outlook_list_foldersList foldersList all Outlook mail folders.
outlook_get_attachmentGet attachmentDownload an email attachment by ID.

Write (7)

ToolOperationDescription
outlook_reply_messageReply to messageSend a reply (or reply-all) to an Outlook message.
outlook_forward_messageForward messageForward an Outlook message to new recipients.
outlook_delete_messageDelete messageMove a message to the Deleted Items folder (reversible).
outlook_update_messageUpdate messageUpdate a message's read status and/or categories.
outlook_move_messageMove messageMove a message to a different mail folder.
outlook_create_draftCreate draftCompose an Outlook email draft without sending.
outlook_update_draftUpdate draftUpdate an existing Outlook email draft.

Destructive (3)

ToolOperationDescription
outlook_send_emailSend emailSend an email from the connected Outlook mailbox (irreversible).
outlook_send_draftSend draftSend a saved draft (irreversible).
outlook_delete_draftDelete draftPermanently delete an Outlook email draft.

On this page