Skip to content
MCP server

Forward Email

Manage Forward Email domains, aliases, mailboxes, contacts and calendars from an AI client

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API, self-hosted
Runs
Locally
Version
1.0.7
Listing updated
1 day ago

About Forward Email

Forward Email is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "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>"
      }
    }
  }
}

Configuration

  • FORWARD_EMAIL_API_KEYAPI key from https://forwardemail.net/my-account/securityRequired
  • FORWARD_EMAIL_ALIAS_USERAlias address for the mailbox, calendar and contact tools
  • FORWARD_EMAIL_ALIAS_PASSWORDGenerated password for that alias

What it does

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

Pricing

Open source

Open-source server; needs a Forward Email account and API key

Prices change. Check forwardemail.net before you buy.

Forward Email 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 to Forward Email

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  5. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  6. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media