archive_emails
Archive selected emails by moving them to the account's auto-detected Archive folder, using email IDs obtained from list_emails_metadata. Reports per-ID succeeded, failed, or unknown status.
Instructions
Archive one or more emails by moving them to the account's Archive folder, auto-detected via the RFC 6154 \Archive flag (falling back to common names like Archive or [Gmail]/All Mail). Use list_emails_metadata first. Partial or ambiguous effects report per-ID succeeded/failed/unknown status and are not retried automatically.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"account_name": "<account_name>",
"email_ids": "<email_ids>"
},
"name": "archive_emails"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mailbox | No | The source mailbox containing the emails. | INBOX |
| email_ids | Yes | List of email_id to archive (obtained from list_emails_metadata). | |
| account_name | Yes | The name of the email account. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |