All tools

m365_list_emails

Microsoft 365 · macOS · Windows

Effect: read (strongest supported action). Status: gated.

Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.

macOS

Purpose

Use this when the user wants their Microsoft 365 / Outlook / Exchange inbox via the cloud — requires a connected M365 account (connect_m365_account). Returns subject, sender, date, and preview. For mail already in the Mac's Mail.app (including an Exchange account added there), use list_emails.

Required inputs

No required inputs are declared in this platform's schema. Optional selectors and runtime requirements may still apply.

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.

Full input schema — macOS
{
  "properties": {
    "folder": {
      "description": "Folder name: inbox (default), sentitems, drafts, deleteditems",
      "type": "string"
    },
    "limit": {
      "description": "Number of emails to return (default 20, max 50)",
      "type": "integer"
    },
    "unread_only": {
      "description": "If true, return only unread emails",
      "type": "boolean"
    }
  },
  "required": [],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "limit": 5
}

Windows

Purpose

List emails from your Microsoft 365 / Outlook inbox. Returns subject, sender, date, and preview.

Required inputs

No required inputs are declared in this platform's schema. Optional selectors and runtime requirements may still apply.

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.

Full input schema — Windows
{
  "properties": {
    "folder": {
      "description": "Folder: inbox (default), sentitems, drafts, deleteditems",
      "type": "string"
    },
    "limit": {
      "description": "Number of emails to return (default 20, max 50)",
      "type": "number"
    },
    "unread_only": {
      "description": "If true, return only unread emails",
      "type": "boolean"
    }
  },
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "limit": 5
}