⚠️ UNOFFICIAL - This is an unofficial MCP server for ForwardEmail. It is not affiliated with, endorsed by, or supported by Forward Email LLC.

An MCP (Model Context Protocol) server that provides comprehensive access to the ForwardEmail API for Claude Desktop, Cline, and other MCP-compatible clients.

• 31 MCP tools covering the ForwardEmail API
• Domain Management - List, create, update, delete domains; verify DNS/SMTP records
• Alias Management - Full CRUD for email aliases with forwarding rules
• Outbound Email - Send emails via API, check limits, manage queue
• Team Collaboration - Invite members, manage roles
• Security - Password generation for IMAP/SMTP access, TXT record encryption
• Async/Await - Built with modern Python async patterns
• Type Safety - Full type hints with Pydantic models

• Python: 3.10+
• uv: 0.4+ (recommended)
• uvx: Included with uv
• A ForwardEmail account with API access
• API key from ForwardEmail Security Settings

uvx --from git+https://github.com/junxit/mcp-forwardemail.git forwardemail-mcp

pip install git+https://github.com/junxit/mcp-forwardemail.git

git clone https://github.com/junxit/mcp-forwardemail.git cd mcp-forwardemail uv pip install -e .

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

{ "mcpServers": { "forwardemail": { "command": "uvx", "args": ["--from", "git+https://github.com/junxit/mcp-forwardemail.git", "forwardemail-mcp"], "env": { "FORWARDEMAIL_API_KEY": "your_api_key_here" } } } }

{ "mcpServers": { "forwardemail": { "command": "uv", "args": ["--directory", "/path/to/mcp-forwardemail", "run", "forwardemail-mcp"], "env": { "FORWARDEMAIL_API_KEY": "your_api_key_here" } } } }

Add to your MCP settings:

{ "forwardemail": { "command": "uvx", "args": ["--from", "git+https://github.com/junxit/mcp-forwardemail.git", "forwardemail-mcp"], "env": { "FORWARDEMAIL_API_KEY": "your_api_key_here" } } }

Alternatively, set the API key as an environment variable:

export FORWARDEMAIL_API_KEY="your_api_key_here"

Ask Claude: "List my ForwardEmail domains"

Ask Claude: "Create an alias called 'support' on example.com that forwards to admin@gmail.com"

Ask Claude: "Send an email from hello@example.com to user@gmail.com with subject 'Test' and body 'Hello!'"

Ask Claude: "Verify the DNS records for example.com"

The following ForwardEmail API endpoints require alias credentials (email + generated password) instead of API token authentication and are not supported in this MCP server:

• Alias Contacts (CardDAV)
• Alias Calendars (CalDAV)
• Alias Messages (IMAP/POP3)
• Alias Folders (IMAP/POP3)

• Verify your API key is correct
• Check that the key is properly set in env section of your MCP config
• Ensure there are no extra spaces or quotes around the key

• Make sure you've added the env section to your MCP configuration
• Restart Claude Desktop after changing the configuration

• Restart Claude Desktop to reload MCP servers
• Check Claude Desktop logs for startup errors

# Clone the repository git clone https://github.com/junxit/mcp-forwardemail.git cd mcp-forwardemail # Install in development mode uv pip install -e ".[dev]" # Run tests uv run pytest tests/ -v # Run the server locally FORWARDEMAIL_API_KEY="your_key" uv run python -m forwardemail_mcp

# Run unit tests uv run pytest tests/ -v # Run with coverage uv run pytest tests/ --cov=forwardemail_mcp # Run single test file uv run pytest tests/test_client.py -v

# If installed via pip/uv pip uninstall forwardemail-mcp # Remove from Claude Desktop config # Edit ~/Library/Application Support/Claude/claude_desktop_config.json # and remove the "forwardemail" entry from mcpServers

# Remove Python cache files find . -type d -name "__pycache__" -exec rm -rf {} + 2>/dev/null find . -type f -name "*.pyc" -delete find . -type f -name "*.pyo" -delete # Remove virtual environments rm -rf .venv venv ENV .uv # Remove build artifacts rm -rf build dist *.egg-info .eggs # Remove test/coverage artifacts rm -rf .pytest_cache .coverage htmlcov .tox # Remove the project directory (if installed from source) cd .. && rm -rf mcp-forwardemail

• ForwardEmail API remains stable at https://api.forwardemail.net
• API authentication continues to use HTTP Basic Auth
• MCP SDK version 1.0+ maintains current interface
• Users have valid ForwardEmail accounts with API access enabled

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

• ForwardEmail - The email service
• ForwardEmail API Docs - Official API documentation
• ForwardEmail GitHub - Official GitHub organization
• MCP Documentation - Model Context Protocol docs

MIT License - see LICENSE file.

Disclaimer: This is an unofficial, community-maintained project. ForwardEmail is a trademark of Forward Email LLC. This project is not affiliated with, endorsed by, or supported by Forward Email LLC.