unmark_flagged
Remove flagged status from emails in the Mail MCP Server. This tool clears starred markers from messages to help organize your inbox by unmarking previously flagged items.
Instructions
Unmark email as flagged (remove starred)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| folder | No | Folder containing the email (default: INBOX) | INBOX |
| message_id | No | Message ID (sequence number) | |
| uid | No | Unique ID of the message |
Implementation Reference
- src/mail_mcp/operations/flags.py:212-226 (handler)Implementation of the unmark_flagged logic.
def unmark_flagged(self, folder: str, uids: int | list[int]) -> bool: """ Remove flagged/starred status from emails. Args: folder: Folder containing the emails uids: Email UID or list of UIDs Returns: True if successful Raises: EmailFlagsError: If operation fails """ return self._store_flags(folder, uids, "-FLAGS", self.FLAG_FLAGGED) - src/mail_mcp/tools/__init__.py:202-216 (registration)Tool definition and registration for unmark_flagged.
Tool( name="unmark_flagged", description="Unmark email as flagged (remove starred)", inputSchema={ "type": "object", "properties": { "folder": { "type": "string", "description": "Folder containing the email (default: INBOX)", "default": "INBOX", }, "message_id": { "type": "string", "description": "Message ID (sequence number)", },