v1.0: Initial Stable Release

🎉 Mail MCP Bridge v1.0

First stable release of Mail MCP Bridge - connect macOS Mail to AI through Model Context Protocol.

✨ Key Features

• 📧 Direct Email Access: AI assistants (Claude, ChatGPT) can directly read your macOS Mail emails
• 🧵 Thread Support: Retrieve entire email conversations with one Message-ID
• ⚡ Lightning Fast: Millisecond-level query response
• 🎯 AI-Optimized: Clean plain text extraction, perfect for AI analysis
• 🔒 Privacy First: Local processing only, emails never leave your Mac

🛠️ MCP Tools

• get_email_path: Get single email file path by Message-ID
• get_thread_paths: Get all paths in an email thread
• read_email: Parse and read single email content
• read_thread: Read entire email thread

🚀 Quick Start

# Clone the repository
git clone https://github.com/fatbobman/mail-mcp-bridge.git
cd mail-mcp-bridge

# Install MCP dependencies
pip3 install mcp

# Configure Claude Desktop
# Edit ~/Library/Application Support/Claude/claude_desktop_config.json
# Add mail-mcp-bridge to mcpServers

# Setup Automator Quick Action for copying Message-ID
# See README.md for detailed instructions

📖 Documentation

• Quick Start Guide
• 中文文档
• API Reference
• Technical Architecture

🔧 Technical Highlights

• Mail V10 Database Support: Works on macOS 12.0+ (Monterey through Tahoe)
• ROWID Discovery: Critical finding that email filename = SQLite ROWID (not remote_id)
• Smart Parsing: Handles multipart emails, various encodings, Base64, quoted-printable
• Threading Headers: Extracts References and In-Reply-To for conversation analysis

🙏 Acknowledgments

Built for the MCP (Model Context Protocol) ecosystem. Inspired by the need to bridge email and AI.

📮 Feedback

• Issues: https://github.com/fatbobman/mail-mcp-bridge/issues
• Author: Fatbobman (Xu Yang)

---

Made with ❤️ for the AI community