Archive emails
archive_emailsMoves selected emails from Inbox to Archive while preserving read state and flags; pass message or thread IDs to clear inbox clutter without deleting.
Instructions
Archive one or more messages: remove them from the Inbox and file them in the Archive mailbox. Use this when the user says archive, clear, or "get this out of my inbox". Read state and flags (to-do, starred) are untouched (use mark_emails for those), and re-running it on the same ids is harmless. Takes message ids from search_emails or get_thread; pass all of a thread's ids to archive the conversation. To file into a specific folder use move_emails; to delete use trash_emails. Reports how many messages were archived and lists any id the server refused.
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": {
"ids": "<ids>"
},
"name": "archive_emails"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | Message ids to act on (1–50), as returned by search_emails or get_thread. To act on a whole conversation, pass every id get_thread lists. |