FastMail MCP Server
Advanced FastMail email management server implementing the Model Context Protocol (MCP) with Docker support and Unraid compatibility.
✨ Features
🤖 AI-Powered Email Management
- Smart Email Analysis - Find genuine action items, filter auto-paid bills
- AI Reply Generation - Generate contextual replies matching your writing style
- Writing Style Learning - Analyze your communication patterns
- Intelligent Summarization - Comprehensive email summaries by category/timeframe
📧 Email Operations
- Advanced Search - Query emails with pagination support
- Automated Organization - Sort emails into hierarchical categories
- Inbox Zero - Aggressive cleanup to achieve true inbox zero
- Conversation Tracking - Thread-aware email handling
👥 Contacts & Calendar
- Smart Contact Management - Sync contacts based on email interactions
- Calendar Integration - Extract events from emails, conflict checking
- Relationship Detection - Identify work contacts vs personal
🏗️ Organization & Structure
- 13-Label System - Simple hierarchical email organization
- Migration Tools - Move from flat to hierarchical structures
- News Digest - Summarize news articles from WSJ and other sources
- Spam Intelligence - Multi-year threat detection (1990s-2024)
🚀 Quick Start
Docker Run
Docker Compose
Unraid Installation
- Go to Community Applications
- Search for "FastMail MCP"
- Click Install
- Configure your FastMail API credentials
🔧 Configuration
Required Environment Variables
Optional Environment Variables
🧠 Claude Integration
Claude Code (CLI)
Add to ~/.mcp.json
:
Claude Desktop
Add to Claude Desktop config:
🛠️ Available MCP Tools
list_mailboxes
- List all mailboxes in the accountlist_emails
- List emails with pagination supportget_email
- Get full details of a specific emailsearch_emails
- Search emails using text queriessend_email
- Send new emails via FastMailreply_to_email
- Reply to specific emails by ID
smart_email_analysis
- Find actionable emails, filter completed tasksgenerate_ai_reply
- AI-powered contextual reply generationanalyze_writing_style
- Learn user communication patternsadaptive_user_learning
- Automatically adapt to user preferencesoptimize_ai_prompts
- Generate optimized prompts for different models
organize_emails
- Auto-organize into appropriate foldersachieve_inbox_zero
- Aggressive inbox cleanupsetup_simple_labels
- Create 13-label hierarchical structurecategorize_with_simple_labels
- Auto-categorize with labelsmigrate_to_hierarchy
- Migrate from flat to hierarchical structurereview_archived_emails
- Review archived items for missed repliesanalyze_hierarchical_structure
- Analyze and suggest improvements
manage_contacts
- Intelligent contact managementlist_contacts
- List existing FastMail contactsmanage_calendar
- Calendar event management and extraction
comprehensive_email_summary
- Generate detailed email summariessummarize_news
- News digest from email sourcesuniversal_setup_wizard
- Automated onboarding wizard
📁 Project Structure
🔒 Security Features
- Non-root execution - Container runs as unprivileged user
- Read-only filesystem - Prevents tampering
- Resource limits - CPU and memory constraints
- Network isolation - No exposed ports (stdio transport)
- Credential isolation - API tokens via environment variables
📖 Documentation
- Docker Setup Guide - Complete Docker deployment instructions
- Claude Integration Guide - Setup for Claude Code & Desktop
- Unraid Installation - Community Applications template
🤝 Contributing
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -m 'Add amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgments
- FastMail for their excellent JMAP API
- Anthropic for the Model Context Protocol specification
- Unraid Community for the Community Applications platform
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables AI-powered email management through FastMail's JMAP API with features like smart email analysis, automated organization, inbox zero automation, and intelligent reply generation. Supports advanced email operations, contact management, calendar integration, and hierarchical email organization systems.