Gmail Manager MCP Server is a high-performance, enterprise-grade Model Context Protocol (MCP) server built with Python and the modern MCP 2.x SDK. It seamlessly connects your AI pair programmers and LLM assistants (Antigravity, Claude Desktop, Cursor, Gemini) directly to your Gmail account using secure IMAP/SMTP over SSL (Port 993/465).
No complex Google Cloud API approvals or quota limits — setup takes less than 2 minutes using standard Gmail App Passwords!
Complete Inbox Lifecycle:
read_inbox: Real-time email retrieval with unread filters and custom folder support.
get_email_details: Extracts full headers, body text, clean HTML, and attachment lists.
search_emails: Advanced search across Subject, Sender, and Body text.
Dynamic Sending & Threaded Replies:
send_email: Send plain text & rich HTML emails with CC/BCC support.
send_email_with_attachment: Attach any document .pdf, .png, .xlsx, .zip) dynamically.
reply_to_email: Thread-aware reply system preserving In-Reply-To and References.
Smart AI Mailbox Intelligence:
categorize_emails: Built-in heuristic classifier (Action Required, Calendar & Meetings, Receipts & Orders, Updates/Newsletters, Direct Discussions).
generate_followup_template: Contextual follow-up template generation based on previously sent emails.
Drafts & Maintenance:
create_draft & list_drafts: Save and manage drafts directly in [Gmail]/Drafts.
delete_email: Move messages to Trash or permanently purge single/batch emails.
clean_bounce_notifications: One-click cleanup of automated mailer-daemon failure emails.
manage_labels & get_mailbox_stats: Star/unstar, mark read/unread, and compute real-time mailbox statistics.
Zero Hardcoded Credentials: Configurable via environment variables .env) or config.json.
Direct SSL/TLS Protocol: Works over official Google endpoints without third-party proxy risks.
Compatible with: Antigravity (AGY), Claude Desktop, Cursor, Gemini AI, and any MCP-compliant client.
server.py – Complete, production-tested MCP 2.x server source code.
banner.svg & uimart_showcase.jpg – High-resolution UI showcase graphics.
requirements.txt – Dependency management mcp>=2.0.0).
config.example.json & .env.example – Configuration templates.
Complete Setup Documentation & Integration Guide.