# Forward Email

> Forward Email is an open-source MCP server for communication. Manage Forward Email domains, aliases, mailboxes, contacts and calendars from an AI client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Website:** https://forwardemail.net/en/blog/docs/mcp
- **Repository:** https://github.com/forwardemail/mcp-server
- **MCP Registry name:** net.forwardemail/mcp-server
- **Categories:** communication, productivity
- **Listing updated:** 2026-11-16

## About

Every endpoint of the Forward Email API is exposed as a tool, 68 in all, so an assistant can handle domains, DNS verification, aliases, outbound SMTP mail, messages and folders, contacts, calendars and Sieve scripts. It runs locally over stdio with npx @forwardemail/mcp-server, so credentials stay in environment variables on your machine and are not sent to the model.

Two credential types matter. An API key covers management endpoints such as domains, aliases, outbound emails and logs. Mailbox features, meaning messages, folders, contacts and calendars, use an alias address and a generated password, which can be set once in the environment or passed per tool call to switch between aliases. A generateAliasPassword tool creates that password.

The README is only a link, so setup details come from the vendor's docs, which show config for Claude Desktop, Cursor and Windsurf and note that it works with ChatGPT too.

## Features

- **68 API tools:** Every Forward Email API endpoint is available as a tool.
- **Local stdio server:** Runs on your machine via npx with credentials kept in the environment.
- **Two auth modes:** API key for management, alias credentials for mailbox data.
- **Per-call alias override:** Pass alias credentials in a tool call to work with several aliases.
- **Mail, calendar and contacts:** Covers messages, folders, contacts, calendars and Sieve scripts.

## Good for

- Create and verify a new domain and its aliases
- Send outbound email through SMTP from an assistant
- Read and organize messages in an alias mailbox
- Manage calendars and contacts by chat
- Update Sieve filtering scripts

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server --env FORWARD_EMAIL_API_KEY='<FORWARD_EMAIL_API_KEY>' --env FORWARD_EMAIL_ALIAS_PASSWORD='<FORWARD_EMAIL_ALIAS_PASSWORD>' -- npx -y @forwardemail/mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@forwardemail/mcp-server"
      ],
      "env": {
        "FORWARD_EMAIL_API_KEY": "<FORWARD_EMAIL_API_KEY>",
        "FORWARD_EMAIL_ALIAS_PASSWORD": "<FORWARD_EMAIL_ALIAS_PASSWORD>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@forwardemail/mcp-server"
      ],
      "env": {
        "FORWARD_EMAIL_API_KEY": "<FORWARD_EMAIL_API_KEY>",
        "FORWARD_EMAIL_ALIAS_PASSWORD": "<FORWARD_EMAIL_ALIAS_PASSWORD>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@forwardemail/mcp-server"
      ],
      "env": {
        "FORWARD_EMAIL_API_KEY": "<FORWARD_EMAIL_API_KEY>",
        "FORWARD_EMAIL_ALIAS_PASSWORD": "<FORWARD_EMAIL_ALIAS_PASSWORD>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@forwardemail/mcp-server"
      ],
      "env": {
        "FORWARD_EMAIL_API_KEY": "<FORWARD_EMAIL_API_KEY>",
        "FORWARD_EMAIL_ALIAS_PASSWORD": "<FORWARD_EMAIL_ALIAS_PASSWORD>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@forwardemail/mcp-server"
      ],
      "env": {
        "FORWARD_EMAIL_API_KEY": "<FORWARD_EMAIL_API_KEY>",
        "FORWARD_EMAIL_ALIAS_PASSWORD": "<FORWARD_EMAIL_ALIAS_PASSWORD>"
      }
    }
  }
}
```

## FAQ

### How is it installed?

Run npx @forwardemail/mcp-server with FORWARD_EMAIL_API_KEY set, via any stdio MCP client.

### Where do I get an API key?

In your Forward Email account under My Account, Security, API Keys.

### Are credentials sent to the model?

No. The docs say they stay in your environment variables.

### What do mailbox tools need?

An alias email and a generated password.

### Is Forward Email free?

Yes. Forward Email is open source, so you can use and self-host it for free.

### How do I add Forward Email to Claude Code?

Run this command in your terminal: claude mcp add mcp-server --env FORWARD_EMAIL_API_KEY='<FORWARD_EMAIL_API_KEY>' --env FORWARD_EMAIL_ALIAS_PASSWORD='<FORWARD_EMAIL_ALIAS_PASSWORD>' -- npx -y @forwardemail/mcp-server

### What are the best alternatives to Forward Email?

The closest alternatives to Forward Email are Ha MCP, Concord MCP, note1, BoardAgent and Callout.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.

---
Source: https://ai-powered.com/mcp/forward-email
