copy_email

macOS

Purpose

Copies an email into another mailbox of the Mac's Apple Mail (Mail.app); the original stays where it is. Requires confirm=true. copied is true only when the target mailbox shows one more copy of the message; otherwise the answer says it is not confirmed. To copy into a mailbox of ANOTHER account, leave account out (with account= the target is looked for in that account only) and use a folder name only that account has. A target that does not exist is refused with the mailboxes that were seen.

Required inputs

• message_id — The message id returned by list_emails or search_emails. Accepts the bare id or the <angle-bracketed> form.
• target_mailbox — Destination folder, by name (see list_email_folders). Nested folders are found by their own name, not by a path.

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"
    },
    "confirm": {
      "default": "false",
      "description": "Set to true to actually copy 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"
    },
    "target_mailbox": {
      "description": "Destination folder, by name (see list_email_folders). Nested folders are found by their own name, not by a path.",
      "type": "string"
    }
  },
  "required": [
    "message_id",
    "target_mailbox"
  ],
  "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",
  "confirm": false,
  "mailbox": "INBOX",
  "message_id": "demo-message-001",
  "target_mailbox": "Projects"
}