FastMail

A Model Context Protocol (MCP) server for integrating with FastMail's JMAP API. This server provides tools for reading emails, searching, managing folders, and sending emails through FastMail.

- 📁 Mailbox Management: List and find mailboxes/folders
- 📧 Email Reading: Get emails from specific folders with previews
- 🔍 Advanced Search: Search by keyword, sender, subject, date range, attachments
- 📤 Email Sending: Send emails with CC/BCC support
- 🎯 Folder Targeting: Search within specific folders
- ⚡ Fast Performance: Uses FastMail's modern JMAP protocol

- Python 3.8+
- FastMail account with API access
- API token from FastMail (Settings → Privacy & Security → Integrations)

git clone <your-repo-url> cd fastmail-mcp-server

- Log into FastMail
- Go to Settings → Privacy & Security → Integrations
- Create a new API token
- Copy the token (starts withfmu1-)

The server will start and listen for MCP commands via stdio.

First, configure your FastMail credentials:

{ "tool": "configure_fastmail", "arguments": { "apiToken": "fmu1-your-token-here" } }

List all mailboxes with their names, roles, and email counts.

{ "tool": "list_mailboxes", "arguments": { "role": "inbox" // Optional: filter by role } }

Find a specific mailbox by name or role.

{ "tool": "find_mailbox", "arguments": { "name": "Work", // Partial matching supported "role": "sent" // Or search by role } }

{ "tool": "get_emails", "arguments": { "mailboxId": "mailbox-id-here", // From list_mailboxes "mailboxName": "Inbox", // Alternative to mailboxId "limit": 20, // Max emails to fetch "includeBody": false // Include full email body } }

{ "tool": "search_emails", "arguments": { "keyword": "project update", // Text search "from_email": "boss@company.com", // From specific sender "subject": "meeting", // Subject contains "mailboxId": "inbox-id", // Search within folder "hasAttachment": true, // Has attachments "after": "2024-01-01", // Date range "before": "2024-12-31", "limit": 50, "includeBody": false } }

Get the full body content of a specific email.

{ "tool": "get_email_body", "arguments": { "emailId": "email-id-here", "format": "text" // "text", "html", or "both" } }

{ "tool": "send_email", "arguments": { "to": ["recipient@example.com"], "cc": ["cc@example.com"], // Optional "bcc": ["bcc@example.com"], // Optional "subject": "Hello from MCP!", "body": "This is the email body.", "isHtml": false // Set to true for HTML emails } }

{ "mcpServers": { "fastmail": { "command": "python", "args": ["/path/to/fastmail_mcp_server.py"] } } }

This server follows the standard MCP protocol and should work with any MCP-compatible client.

fastmail-mcp-server/ ├── fastmail_mcp_server.py # Main server implementation ├── requirements.txt # Python dependencies ├── pyproject.toml # Package configuration ├── README.md # This file └── examples/ # Example usage scripts └── test_server.py # Test script

- API Token Security: Never commit your API token to version control
- Permissions: The API token has access to your entire FastMail account
- Network: All communication uses HTTPS with FastMail's secure APIs
- Authentication Error: Verify your API token is correct and has proper permissions
- Connection Error: Check your internet connection and FastMail service status
- Missing Emails: Ensure you're searching in the correct mailbox

Enable debug logging by setting environment variable:

export MCP_DEBUG=1 python fastmail_mcp_server.py

- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request

MIT License - see LICENSE file for details.

- FastMailfor their excellent JMAP API
- Model Context Protocolby Anthropic
- JMAP Specificationby the IETF

- FastMail API Documentation
- JMAP Specification
- MCP Documentation

A bridge server connecting Agent Communication Protocol (ACP) agents with Model Context Protocol (MCP) clients.