fastmail-mcp-server

A Model Context Protocol (MCP) server for Fastmail. Enables any MCP-compatible AI assistant to read, search, send, and manage emails, calendars, and contacts in a Fastmail account via the JMAP protocol.

• Node.js 18 or later
• A Fastmail account (Standard or Professional plan)
• A Fastmail API token with JMAP access

1. Log in to Fastmail
2. Go to Settings → Privacy & Security → Manage API tokens
3. Click New API token
4. Grant access to Mail, Calendars, and Contacts (read and write)
5. Copy the generated token

npm install @jordonh19/fastmail-mcp-server

Or run directly:

npx @jordonh19/fastmail-mcp-server

This MCP server works with any AI assistant that supports the Model Context Protocol. Below are examples for popular MCP clients.

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "fastmail": {
      "command": "npx",
      "args": ["@jordonh19/fastmail-mcp-server"],
      "env": {
        "FASTMAIL_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

export FASTMAIL_API_TOKEN="your-api-token-here"
claude mcp add fastmail -- npx @jordonh19/fastmail-mcp-server

Add to your Cursor MCP configuration (.cursor/mcp.json):

{
  "mcpServers": {
    "fastmail": {
      "command": "npx",
      "args": ["@jordonh19/fastmail-mcp-server"],
      "env": {
        "FASTMAIL_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Add to your Windsurf MCP configuration (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "fastmail": {
      "command": "npx",
      "args": ["@jordonh19/fastmail-mcp-server"],
      "env": {
        "FASTMAIL_API_TOKEN": "your-api-token-here"
      }
    }
  }
}