Mailbox Manager
Mailbox Manager is an MCP server that connects to Gmail via Google OAuth and exposes tools to search, read, and triage email—including listing labels, searching messages, fetching message/thread details, generating inbox digests, and performing actions like apply labels, archive, and mark read/unread.
Overview
The Mailbox Manager MCP server provides direct programmatic access to authenticated Gmail mailboxes. Developers can search messages using familiar Gmail syntax in gmail_search_messages (e.g., from:alice@x.com is:unread newer_than:7d), fetch threads with gmail_get_thread, and generate digests via gmail_today_inbox_digest. Read-only tools like gmail_sender_stats reveal sender volumes, while write tools such as gmail_apply_labels and gmail_archive_messages enable organization without full Gmail API setup.
Key Capabilities
List available labels with gmail_list_labels to prepare for gmail_apply_labels operations. Retrieve message details via gmail_get_message (metadata, snippet, or full body) or entire threads with gmail_get_thread. Surface priorities using gmail_needs_attention for unread, important, starred, or VIP-sender mail, and track sender patterns with gmail_sender_stats; toggle status with gmail_mark_read, gmail_mark_unread, or gmail_archive_messages.
Use Cases
Run gmail_today_inbox_digest daily to list inbox arrivals from the past 24 hours, grouped by sender for triage. Identify noisy senders like marketing@x.com via gmail_sender_stats, search them with gmail_search_messages, then bulk-archive using gmail_archive_messages. Review gmail_needs_attention results, fetch threads with gmail_get_thread, apply custom labels via gmail_apply_labels, and mark invoices as read with gmail_mark_read after subject:invoice newer_than:7d queries.
Who This Is For
Developers building AI agents that query gmail_search_messages or automate gmail_apply_labels workflows. Data analysts extracting gmail_sender_stats or message metadata for email volume reports. Intermediate users comfortable with Gmail search syntax, from solo scripters to teams handling label-based organization.