Add IMAP flag-based search filters to list_emails_metadata

[jbkjr]

Summary

• Add seen, flagged, answered tri-state filter parameters to list_emails_metadata
• Enable compound IMAP searches (e.g., unread emails from a specific sender)

New Parameters

Parameter	Values	Description
seen	true/false/null	Filter by read status (SEEN/UNSEEN)
flagged	true/false/null	Filter by starred status (FLAGGED/UNFLAGGED)
answered	true/false/null	Filter by replied status (ANSWERED/UNANSWERED)

Example Usage

# Get unread emails from a specific sender
list_emails_metadata(account_name="work", seen=False, from_address="boss@example.com")

# Get flagged/starred emails
list_emails_metadata(account_name="work", flagged=True)

Test plan

• Unit tests added for _build_search_criteria method
• Integration tests updated for handler and MCP tools
• All 110 tests passing

🤖 Generated with Claude Code

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!