Ms Mail Skill

Outlook Mail Skill

Send, read, search, reply to, and handle attachments of email using the Microsoft Graph API (Outlook / Microsoft 365).

Tool: ms_mail

Consolidated Outlook Mail tool with an operation parameter.

Operations

Every read/search result includes a has_attachments boolean per message — check it before calling list_attachments / download_attachments.

send - Send an email

Example - Send plain text email:

jsonCopy code
{
  "operation": "send",
  "to": "alice@contoso.com",
  "subject": "Meeting Tomorrow",
  "body": "Hi,\n\nJust a reminder about our meeting tomorrow at 2pm.\n\nBest regards"
}

Example - Send to multiple recipients with CC:

jsonCopy code
{
  "operation": "send",
  "to": "alice@contoso.com, bob@contoso.com",
  "cc": "manager@contoso.com",
  "subject": "Weekly Report",
  "body": "<h1>Weekly Report</h1><p>Highlights...</p>",
  "body_type": "html"
}

read - Read a message or list recent mail

Each returned message includes has_attachments (boolean). When true, use list_attachments / download_attachments with that message_id.

Example - Read a specific message:

jsonCopy code
{
  "operation": "read",
  "message_id": "AAMkAGI2..."
}

Example - List the 20 most recent messages:

jsonCopy code
{
  "operation": "read",
  "max_results": 20
}

search - Search messages

Microsoft Graph search matches across subject, body, sender, and recipients. Use natural keywords (e.g. invoice, from:jane quarterly plan); it does not use Gmail-style operators.

Example:

jsonCopy code
{
  "operation": "search",
  "query": "quarterly plan",
  "search_max_results": 20
}

reply - Reply to a message

Example:

jsonCopy code
{
  "operation": "reply",
  "reply_message_id": "AAMkAGI2...",
  "comment": "Thanks - looks good to me.",
  "reply_all": true
}

list_attachments - List a message's attachments (metadata only)

Returns attachments: [{attachment_id, name, content_type, size, is_inline, kind}] and count. kind is "file" for a downloadable file attachment; other values (itemAttachment, referenceAttachment) are shown so you know they cannot be downloaded as bytes. Inline images are excluded unless include_inline: true. This op does NOT download bytes — it is a cheap metadata lookup.

Example:

jsonCopy code
{
  "operation": "list_attachments",
  "message_id": "AAMkAGI2..."
}

download_attachments - Download file attachments into the workspace

Saves each file attachment into the workflow workspace and returns:

• attachments: [{filename, path, mime_type, size, ref}] — path is the absolute file path on disk (feed it to the Document Parser's file_path).
• download_dir — the absolute directory the files landed in (feed it to the Document Parser's input_dir to parse all of them).
• count, and skipped: [{name, reason}] for anything not downloaded (inline images, item/reference attachments, or files over the size limit).

Only real file attachments are downloaded. Item/reference attachments and (by default) inline images are skipped. Bytes are never returned inline — you get a path/reference, not the file contents.

Example - download all file attachments:

jsonCopy code
{
  "operation": "download_attachments",
  "message_id": "AAMkAGI2..."
}

Example - download one specific attachment:

jsonCopy code
{
  "operation": "download_attachments",
  "message_id": "AAMkAGI2...",
  "attachment_id": "AAMkAGI2...=="
}

Parsing an attachment (e.g. a PDF)

ms_mail downloads the file; it does NOT extract text. To read a PDF's contents, pair it with the Document Parser node on the canvas:

1. ms_mail download_attachments → returns download_dir (and per-file path).
2. Document Parser with input_dir = {{msMail.download_dir}} and file_pattern = *.pdf (or file_path = {{msMail.attachments[0].path}} for one file).
3. Document Parser returns documents[].content — the extracted text.

Common Workflows

1. Triage recent mail: read with no ID to list recent messages, then read a specific message_id for full content.
2. Find a thread: search by keyword, take the message_id, then reply.
3. Send an update: send to one or more recipients, optionally as HTML.
4. Process an attachment: on a message with has_attachments: true, call download_attachments, then run the Document Parser over download_dir to get the text.

Shared mailboxes

Every operation accepts an optional mailbox field. Leave it empty to use the signed-in user's own mailbox (default). Set it to a shared/other mailbox address (e.g. support@contoso.com) to operate on that mailbox instead — the node then calls /users/{address}/… rather than /me/….

Requirements for a shared mailbox:

• The signed-in account must have Full Access on the mailbox (and Send As / Send on Behalf to send from it).
• The Mail.ReadWrite.Shared / Mail.Send.Shared scopes must be granted (reconnect in the Credentials Modal after these are added to re-consent).

Example - read a shared mailbox:

jsonCopy code
{
  "operation": "read",
  "mailbox": "support@contoso.com",
  "max_results": 20
}

Setup Requirements

1. Connect the Outlook Mail node to an AI Agent's input-tools handle.
2. Authenticate with Microsoft Graph in the Credentials Modal (Work/School account).
3. Ensure the Mail.Send and Mail.ReadWrite scopes are granted (plus the .Shared variants if you use the mailbox field for a shared mailbox).