home / mcp / fastmail mcp server

FastMail MCP Server

FastMail MCP Server for advanced email management with AI-powered features, Docker support, and Unraid compatibility

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "gr3enarr0w-fastmail-mcp-server": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "fastmail-mcp-server",
        "node",
        "src/index.js"
      ],
      "env": {
        "FASTMAIL_EMAIL": "[email protected]",
        "FASTMAIL_API_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

You can manage FastMail with automated AI-powered email organization and powerful MCP (Model Context Protocol) integration. This server lets you connect an MCP client to control and query your FastMail account, organize messages, summarize content, and automate workflows—all through a consistent MCP interface.

How to use

Connect to the MCP server from your MCP client to run actions like listing mailboxes, searching emails, and generating AI-assisted replies. You can use the Claude integration flow to bridge your client to the server, enabling you to perform tasks from a conversational or scripted interface. The server exposes a range of tools for email management, AI-powered analysis, and calendar/contact integration, all driven by MCP commands.

How to install

# Docker Run (standalone container)
docker run -d \
  --name fastmail-mcp-server \
  --restart unless-stopped \
  -e FASTMAIL_API_TOKEN=your_token \
  -e [email protected] \
  gr3enarr0w/fastmail-mcp-server:latest

# Docker Compose (recommended for multi-service environments)
verson: '3.8'
services:
  fastmail-mcp-server:
    image: gr3enarr0w/fastmail-mcp-server:latest
    container_name: fastmail-mcp-server
    restart: unless-stopped
    environment:
      - FASTMAIL_API_TOKEN=your_token
      - [email protected]

# Unraid installation steps (manual UI flow)
# 1. Go to Community Applications
# 2. Search for "FastMail MCP" and install
# 3. Provide your FastMail API credentials in the configuration UI

Additional startup and integration notes

Two practical ways to connect programmatically are through a local stdio bridge and through a remote MCP bridge. The following configuration snippet shows how to register a local stdio MCP server in your MCP client profile. You can adapt it to your client’s configuration flow.

Claude integration example (stdio config)

Use a local stdio bridge to expose the MCP server to Claude Code or Claude Desktop. The exact command and arguments are shown here for your reference.

{
  "mcpServers": {
    "fastmail-server": {
      "command": "docker",
      "args": ["exec", "-i", "fastmail-mcp-server", "node", "src/index.js"]
    }
  }
}

Security and reliability notes

The container runs with non-root privileges and a read-only filesystem where possible, with explicit resource limits and network isolation. Credentials such as API tokens are passed via environment variables to isolate secrets from code.

Available tools

list_mailboxes

List all mailboxes in the account

list_emails

List emails with pagination support

get_email

Get full details of a specific email

search_emails

Search emails using text queries

send_email

Send new emails via FastMail

reply_to_email

Reply to specific emails by ID

smart_email_analysis

Find actionable items and filter tasks from emails

generate_ai_reply

AI-powered contextual reply generation

analyze_writing_style

Learn user communication patterns

adaptive_user_learning

Automatically adapt to user preferences

optimize_ai_prompts

Generate optimized prompts for different models

organize_emails

Auto-organize emails into hierarchical folders

achieve_inbox_zero

Aggressive inbox cleanup to reach inbox zero

setup_simple_labels

Create a 13-label hierarchical structure for organization

categorize_with_simple_labels

Auto-categorize emails with labels

migrate_to_hierarchy

Migrate from flat to hierarchical structures

review_archived_emails

Review archived items for missed replies

analyze_hierarchical_structure

Analyze and suggest improvements to structure

manage_contacts

Intelligent contact management based on email interactions

list_contacts

List existing FastMail contacts

manage_calendar

Calendar event management and extraction

comprehensive_email_summary

Generate detailed email summaries

summarize_news

News digest from email sources

universal_setup_wizard

Automated onboarding wizard