Fastmail

You can connect your Fastmail account to an MCP client through this Fastmail MCP Server to search mailboxes, query emails, retrieve messages, and send new emails. This server exposes a simple MCP interface over HTTP so your client can interact with Fastmail programmatically while keeping authentication separate and secure.

How to use

This MCP server provides endpoints to list mailboxes, query emails with filters and sorting, fetch specific messages by ID, and send new emails. Use an MCP client to perform actions such as discovering your mailbox structure, searching for messages with criteria (sender, subject, date range, or keywords), retrieving message details, and composing/sending messages directly from your client.

Typical usage patterns include: listing all mailboxes to understand your folder structure, running filtered queries to find messages that match certain criteria, retrieving full message content when needed, and sending new messages from your application or workflow. Ensure you supply your API token in requests to authenticate with Fastmail.

How to install

Prerequisites you need before installing: Node.js (with npm or pnpm) and a compatible MCP client. You will also need a Fastmail API token with the appropriate scopes.

Install dependencies and start the server locally in development mode, or prepare for production build and deployment.

pnpm install
pnpm dev
pnpm build
pnpm start
pnpm deploy

Configure your MCP client to connect to Fastmail MCP Server

{
  "mcpServers": {
    "fastmail": {
      "type": "http",
      "url": "https://fastmail-mcp.vercel.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_FASTMAIL_API_TOKEN"
      }
    }
  }
}

Security and tokens

Keep your API token secure. Do not commit it to version control. Consider using environment variables or a secrets manager to protect the token in production deployments.

API Endpoints

The server exposes an MCP protocol endpoint and a health check endpoint to monitor status.

Available tools

mailbox_get

Get mailbox information (folders) by listing all mailboxes or retrieving specific ones by ID.

email_query

Query emails with filters and sorting, including mailbox scope, sender, recipient, subject, keywords, and date ranges.

email_get

Get specific emails by their IDs with optional body values (text/plain, text/html) and properties.

email_send

Send emails with support for plain text, HTML, or multipart messages and optional identity.