
Lets your agent manage your Forward Email domains, aliases and DNS checks, send email, and work with your mailbox, contacts and calendars.
by Forwardemail· CommunicationUnclaimed · Yours? Claim it
4 images
About
Forward Email's own MCP server lets your agent run your Forward Email account in plain words. Forward Email is an open-source, privacy-first email service, and the server exposes every endpoint of its API as a tool, from domains and aliases to your mailbox, contacts and calendars. What you can do with it - Add domains, check their DNS and SMTP records, and test custom S3 storage - Create, update and delete aliases, and generate alias passwords for IMAP and SMTP - Send email, list what you've sent, check its delivery status and your sending limit - Search, read, draft, flag and delete messages, and organise folders - Manage contacts (CardDAV), and calendars and events (CalDAV) - Write and activate Sieve filter scripts, and manage domain members, invites, catch-all passwords and delivery logs - Encrypt forwarding records for your DNS TXT entries How it connects It runs on your machine with npx @forwardemail/mcp-server, over stdio. Add your Forward Email API key (My Account, then Security, then API Keys) as FORWARD_EMAIL_API_KEY. The mailbox, folder, contact and calendar tools also need an alias: set FORWARD_EMAIL_ALIAS_USER to the alias address and FORWARD_EMAIL_ALIAS_PASSWORD to a password generated for it, or pass them with each request. Forward Email's guide covers Claude Desktop and Cursor, and it works in any agent that runs local MCP servers. Good to know - Your credentials stay in your environment and aren't sent to the model. The server is stateless and doesn't store your mail. - It can send email and delete domains, aliases and messages, so check what your agent is about to do. - Its source is on GitHub under the BUSL-1.1 licence.
Plugins people install alongside Forward Email.
Once it’s added
“Check the DNS and SMTP verification status for all my domains and tell me if anything needs attention.”
“Create a new alias [email protected] that forwards to my personal email.”
“Send an email from [email protected] to [email protected] with the subject 'Meeting Tomorrow'.”
“Find all unread emails from the last week that mention 'invoice'.”
“Create a calendar called 'Work' and add a meeting for tomorrow at 2pm called 'Team Standup'.”
“Write a Sieve script for [email protected] that auto-replies to say we'll get back to them soon.”
Before you add it
Reads only
Your domains, aliases and their DNS and SMTP verification status · Sent email, delivery status, sending limits and logs · Messages, folders, contacts and calendar events (with an alias's credentials)
Makes changes · your agent can ask first
Creates, changes and deletes domains, aliases and catch-all passwords · Sends email and saves drafts · Changes messages, folders, contacts, calendars and events · Creates and activates Sieve filter scripts
From people who use it
Step by step
Nothing new reaches your agent until a person has looked at it.
Scanned on every change, and again when our rules improve.
Runs on your machine.
claude_desktop_config.json{
"mcpServers": {
"forward-email": {
"command": "npx",
"args": [
"-y",
"@forwardemail/[email protected]"
],
"env": {
"FORWARD_EMAIL_API_KEY": "<FORWARD_EMAIL_API_KEY>"
}
}
}
}Runs on your machine.
Add to VS Codecode --add-mcp '{"name":"forward-email","command":"npx","args":["-y","@forwardemail/[email protected]"],"env":{"FORWARD_EMAIL_API_KEY":"<FORWARD_EMAIL_API_KEY>"}}'copilot mcp add forward-email --env FORWARD_EMAIL_API_KEY=<FORWARD_EMAIL_API_KEY> -- npx -y @forwardemail/[email protected]
Runs on your machine.
Add to Cursor.cursor/mcp.json{
"mcpServers": {
"forward-email": {
"command": "npx",
"args": [
"-y",
"@forwardemail/[email protected]"
],
"env": {
"FORWARD_EMAIL_API_KEY": "<FORWARD_EMAIL_API_KEY>"
}
}
}
}Runs on your machine.
claude mcp add -e FORWARD_EMAIL_API_KEY=<FORWARD_EMAIL_API_KEY> forward-email -- npx -y @forwardemail/[email protected]
Runs on your machine.
codex mcp add --env FORWARD_EMAIL_API_KEY=<FORWARD_EMAIL_API_KEY> forward-email -- npx -y @forwardemail/[email protected]
Runs on your machine.
~/.gemini/config/mcp_config.json{
"mcpServers": {
"forward-email": {
"command": "npx",
"args": [
"-y",
"@forwardemail/[email protected]"
],
"env": {
"FORWARD_EMAIL_API_KEY": "<FORWARD_EMAIL_API_KEY>"
}
}
}
}Runs on your machine.
gemini mcp add -e FORWARD_EMAIL_API_KEY=<FORWARD_EMAIL_API_KEY> forward-email npx -y @forwardemail/[email protected]
Runs on your machine.
Runs on your machine.
opencode mcp add forward-email --env FORWARD_EMAIL_API_KEY=<FORWARD_EMAIL_API_KEY> -- npx -y @forwardemail/[email protected]
Runs on your machine.
~/.hermes/config.yaml{
"mcp_servers": {
"forward-email": {
"command": "npx",
"args": [
"-y",
"@forwardemail/[email protected]"
],
"env": {
"FORWARD_EMAIL_API_KEY": "<FORWARD_EMAIL_API_KEY>"
}
}
}
}FORWARD_EMAIL_API_KEYRequiredSecretAPI key from https://forwardemail.net/my-account/securityFORWARD_EMAIL_ALIAS_USEROptionalAlias address for the mailbox, calendar and contact toolsFORWARD_EMAIL_ALIAS_PASSWORDOptionalSecretGenerated password for that aliasReplace each <NAME> placeholder with your own value.
Scanned and passed · checked 6 h ago
No reviews yet. Used Forward Email? Say how it went.
Write a reviewPlugins people install alongside Forward Email.
Two paired skills for email triage: teach it how you handle mail once, then it sorts new mail and drafts replies that it never sends.
Lets your agent search and read your Gmail or Outlook mail, save drafts, manage Inbox Zero's automation rules and check your email stats.
German email rewriter: turns angry or emotional German emails into polite, factual ones that fit German lawyers' professional rules.
Nobody has shared how they use Forward Email yet.
Security scan
Passed
Safe to install in every agent it supports. Runs on your machine.