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.