Mark emails read, to-do or starred
mark_emailsSet or clear read, unread, to-do, and starred flags on messages so you can mark what you read, flag items needing action, and keep or star messages as requested.
Instructions
Set or clear the flags on one or more messages: read / unread, to-do, and starred. Reading a message with get_email, get_thread or search_emails never changes its read state, so call this when the user wants what you read marked read or says "keep this unread"; set todo when a message needs action from the user ("flag this for me", "add it to my to-dos"), clear it when the to-do is done ("mark it done"), and set starred for "star this". Several flags go in one call; a flag you leave out is untouched. To finish a to-do, call this tool with todo: false (plus read: true if it is still unread), then archive_emails. Takes message ids from search_emails or get_thread; folders are untouched, and re-running it on the same ids is harmless. To get a message out of the inbox use archive_emails or move_emails instead; to mark something as spam, use move_emails with Junk. Reports how many messages were marked 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": "mark_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. | |
| read | No | true marks the messages read, false marks them unread. Leave out to keep read state. | |
| todo | No | true flags the messages as a to-do for the user, false clears the to-do (e.g. once it is done). Leave out to keep it. | |
| starred | No | true stars the messages, false removes the star. Leave out to keep it. |