flag_email

macOS

Purpose

Flags an email in the Mac's Apple Mail (Mail.app) with a color, or clears its flag. color is one of red, orange, yellow, green, blue, purple, gray, or none to clear (default red). The answer is what Mail reads back after the change. Pass account= and mailbox= (from list_emails/search_emails) so the message is found without scanning. Called without confirm it returns a preview and changes nothing; pass confirm=true to flag.

Required inputs

• message_id — The message id returned by list_emails or search_emails. Accepts the bare id or the <angle-bracketed> form.

Permissions and confirmation

Explicit confirmation parameter: inspect the schema and tool description before any real call. The documentation example keeps confirm false. Obtain user authorization before performing the action.

• Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.

{
  "properties": {
    "account": {
      "description": "Mail.app account the message lives in (returned alongside the id). Pass it so the message is found in the right account.",
      "type": "string"
    },
    "color": {
      "description": "red, orange, yellow, green, blue, purple, gray, or none to clear the flag. Default red.",
      "type": "string"
    },
    "confirm": {
      "default": "false",
      "description": "Set to true to actually flag the message. Defaults to false.",
      "type": "boolean"
    },
    "mailbox": {
      "description": "Folder the message is in. Passing it skips searching the other folders.",
      "type": "string"
    },
    "message_id": {
      "description": "The message id returned by list_emails or search_emails. Accepts the bare id or the <angle-bracketed> form.",
      "type": "string"
    }
  },
  "required": [
    "message_id"
  ],
  "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.

{
  "account": "Demo iCloud",
  "color": "orange",
  "confirm": false,
  "mailbox": "INBOX",
  "message_id": "demo-message-001"
}