@forwardemail/mcp-server

Model Context Protocol (MCP) server for Forward Email. Connect AI assistants to your inbox.

Overview

This package provides a local MCP server that wraps the Forward Email API. It lets AI agents (Claude, ChatGPT, Cursor, Windsurf, and others) send email, manage domains, and read your inbox through natural language.

The server runs locally on your machine via stdio. Your API key never leaves your device.

Install

npm install -g @forwardemail/mcp-server

Or run directly with npx:

npx @forwardemail/mcp-server

Setup

1. Get your API key

2. Set the environment variable

export FORWARD_EMAIL_API_KEY=your-api-key

3. Configure your AI client

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "forwardemail": {
      "command": "npx",
      "args": ["@forwardemail/mcp-server"],
      "env": {
        "FORWARD_EMAIL_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "forwardemail": {
      "command": "npx",
      "args": ["@forwardemail/mcp-server"],
      "env": {
        "FORWARD_EMAIL_API_KEY": "your-api-key"
      }
    }
  }
}

Available Tools

This server exposes the complete Forward Email API as MCP tools. Every endpoint is covered.

Account

getAccount - Get your account details
updateAccount - Update your account

Logs

downloadLogs - Download email delivery logs

Contacts (CardDAV)

listContacts - List all contacts
createContact - Create a contact
getContact - Get a contact by ID
updateContact - Update a contact
deleteContact - Delete a contact

Calendars (CalDAV)

listCalendars - List all calendars
createCalendar - Create a calendar
getCalendar - Get a calendar by ID
updateCalendar - Update a calendar
deleteCalendar - Delete a calendar

Calendar Events (CalDAV)

listCalendarEvents - List all calendar events
createCalendarEvent - Create a calendar event
getCalendarEvent - Get a calendar event by ID
updateCalendarEvent - Update a calendar event
deleteCalendarEvent - Delete a calendar event

Domains

listDomains - List all domains
createDomain - Create a new domain
getDomain - Get a domain by ID or name
updateDomain - Update a domain
deleteDomain - Delete a domain
verifyDomainRecords - Verify domain DNS records
verifySmtpRecords - Verify domain SMTP records
testS3Connection - Test custom S3 connection for a domain

Domain Catch-All Passwords

listCatchAllPasswords - List domain-wide catch-all passwords
createCatchAllPassword - Create a domain-wide catch-all password
deleteCatchAllPassword - Remove a domain-wide catch-all password

Domain Invites

acceptDomainInvite - Accept a domain invite
createDomainInvite - Invite a user to a domain
removeDomainInvite - Remove a domain invite

Domain Members

updateDomainMember - Update a domain member role
removeDomainMember - Remove a member from a domain

Aliases

listAliases - List aliases for a domain
createAlias - Create a new alias
getAlias - Get an alias by ID
updateAlias - Update an alias
deleteAlias - Delete an alias
generateAliasPassword - Generate or set a password for an alias

Sieve Scripts

listSieveScripts - List Sieve scripts for an alias
createSieveScript - Create a Sieve script for an alias
getSieveScript - Get a Sieve script by ID
updateSieveScript - Update a Sieve script
deleteSieveScript - Delete a Sieve script
activateSieveScript - Activate a Sieve script

Sieve Scripts (Alias Auth)

listSieveScriptsAliasAuth - List Sieve scripts (alias auth)
createSieveScriptAliasAuth - Create a Sieve script (alias auth)
getSieveScriptAliasAuth - Get a Sieve script (alias auth)
updateSieveScriptAliasAuth - Update a Sieve script (alias auth)
deleteSieveScriptAliasAuth - Delete a Sieve script (alias auth)
activateSieveScriptAliasAuth - Activate a Sieve script (alias auth)

Emails (Outbound SMTP)

listEmails - List outbound SMTP emails
sendEmail - Send an email via outbound SMTP
getEmailLimit - Get outbound SMTP email sending limit
getEmail - Get an outbound SMTP email by ID
deleteEmail - Delete an outbound SMTP email

Messages (IMAP)

listMessages - List and search messages in a folder
createMessage - Create a new message (draft)
getMessage - Get a message by ID
updateMessage - Update a message
deleteMessage - Delete a message

Folders (IMAP)

listFolders - List all folders
createFolder - Create a new folder
getFolder - Get a folder by ID
updateFolder - Update a folder
deleteFolder - Delete a folder

Encrypt

encryptRecord - Encrypt a plaintext Forward Email TXT record

Development

git clone https://github.com/forwardemail/mcp-server.git
cd mcp-server
pnpm install
pnpm test

License

BUSL-1.1

MCP Servers