# Mailoo - Email MCP Server

> Mailoo - Email MCP Server is an open-source MCP server for communication. Run email for several accounts from an assistant, with read-only and dry-run guardrails. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/bitfloo/mailoo
- **MCP Registry name:** io.github.Bitfloo/mailoo
- **Categories:** [communication](https://ai-powered.com/categories/communication), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

Mailoo is a self-hosted fork of email-mcp maintained by Bitfloo, and its notable trait is how cautious the defaults are. The quickstarts configure read-only mode first, which exposes only 31 read-only tools and turns off writes, watchers, hooks and schedulers, and toolset profiles (full, core, minimal) shrink the tool list for smaller context budgets. High-risk tools such as send_email accept a dryRun preview.

It connects to IMAP and SMTP accounts, with experimental OAuth2 for Gmail and Microsoft 365, and covers drafts and templates, scheduled sends, IMAP IDLE watching, labels and bulk operations, calendar and reminders, ManageSieve filters, SPF/DKIM/DMARC header checks, analytics and optional AI triage. In total the README counts up to 57 tools, 7 prompts and 6 resources.

Security notes cover execFile-only shell calls, SSRF protection on webhooks, symlink-safe attachment saving and 0600 config files. Mail content goes to your MCP client's model provider, and usage reporting is off by default.

## Features

- **Read-only mode:** Disables write tools, watchers and schedulers at startup.
- **Toolset profiles:** Full, core and minimal sets to fit an agent's context budget.
- **Multi-account IMAP/SMTP:** Search and read mail, threads and attachments across accounts.
- **Dry-run sends:** Preview high-risk actions such as sending before they happen.
- **Calendar and filters:** ICS calendars, reminders and ManageSieve server-side filters.
- **AI triage:** Optional classification with presets and alerts.

## Good for

- Summarise unread mail across several accounts
- Draft and schedule replies with a preview before sending
- Manage server-side Sieve filters from chat
- Watch an inbox for important messages and raise desktop alerts

## Install

### Claude Code (Terminal)

```sh
claude mcp add mailoo --env MCP_EMAIL_ADDRESS='<MCP_EMAIL_ADDRESS>' --env MCP_EMAIL_PASSWORD='<MCP_EMAIL_PASSWORD>' --env MCP_EMAIL_IMAP_HOST='<MCP_EMAIL_IMAP_HOST>' --env MCP_EMAIL_SMTP_HOST='<MCP_EMAIL_SMTP_HOST>' --env MCP_EMAIL_OAUTH2_CLIENT_SECRET='<MCP_EMAIL_OAUTH2_CLIENT_SECRET>' --env MCP_EMAIL_OAUTH2_REFRESH_TOKEN='<MCP_EMAIL_OAUTH2_REFRESH_TOKEN>' --env MCP_EMAIL_ALERT_WEBHOOK_URL='<MCP_EMAIL_ALERT_WEBHOOK_URL>' --env MCP_EMAIL_HTTP_TOKEN='<MCP_EMAIL_HTTP_TOKEN>' -- npx -y @bitfloo/mailoo
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mailoo": {
      "command": "npx",
      "args": [
        "-y",
        "@bitfloo/mailoo"
      ],
      "env": {
        "MCP_EMAIL_ADDRESS": "<MCP_EMAIL_ADDRESS>",
        "MCP_EMAIL_PASSWORD": "<MCP_EMAIL_PASSWORD>",
        "MCP_EMAIL_IMAP_HOST": "<MCP_EMAIL_IMAP_HOST>",
        "MCP_EMAIL_SMTP_HOST": "<MCP_EMAIL_SMTP_HOST>",
        "MCP_EMAIL_OAUTH2_CLIENT_SECRET": "<MCP_EMAIL_OAUTH2_CLIENT_SECRET>",
        "MCP_EMAIL_OAUTH2_REFRESH_TOKEN": "<MCP_EMAIL_OAUTH2_REFRESH_TOKEN>",
        "MCP_EMAIL_ALERT_WEBHOOK_URL": "<MCP_EMAIL_ALERT_WEBHOOK_URL>",
        "MCP_EMAIL_HTTP_TOKEN": "<MCP_EMAIL_HTTP_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mailoo": {
      "command": "npx",
      "args": [
        "-y",
        "@bitfloo/mailoo"
      ],
      "env": {
        "MCP_EMAIL_ADDRESS": "<MCP_EMAIL_ADDRESS>",
        "MCP_EMAIL_PASSWORD": "<MCP_EMAIL_PASSWORD>",
        "MCP_EMAIL_IMAP_HOST": "<MCP_EMAIL_IMAP_HOST>",
        "MCP_EMAIL_SMTP_HOST": "<MCP_EMAIL_SMTP_HOST>",
        "MCP_EMAIL_OAUTH2_CLIENT_SECRET": "<MCP_EMAIL_OAUTH2_CLIENT_SECRET>",
        "MCP_EMAIL_OAUTH2_REFRESH_TOKEN": "<MCP_EMAIL_OAUTH2_REFRESH_TOKEN>",
        "MCP_EMAIL_ALERT_WEBHOOK_URL": "<MCP_EMAIL_ALERT_WEBHOOK_URL>",
        "MCP_EMAIL_HTTP_TOKEN": "<MCP_EMAIL_HTTP_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mailoo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@bitfloo/mailoo"
      ],
      "env": {
        "MCP_EMAIL_ADDRESS": "<MCP_EMAIL_ADDRESS>",
        "MCP_EMAIL_PASSWORD": "<MCP_EMAIL_PASSWORD>",
        "MCP_EMAIL_IMAP_HOST": "<MCP_EMAIL_IMAP_HOST>",
        "MCP_EMAIL_SMTP_HOST": "<MCP_EMAIL_SMTP_HOST>",
        "MCP_EMAIL_OAUTH2_CLIENT_SECRET": "<MCP_EMAIL_OAUTH2_CLIENT_SECRET>",
        "MCP_EMAIL_OAUTH2_REFRESH_TOKEN": "<MCP_EMAIL_OAUTH2_REFRESH_TOKEN>",
        "MCP_EMAIL_ALERT_WEBHOOK_URL": "<MCP_EMAIL_ALERT_WEBHOOK_URL>",
        "MCP_EMAIL_HTTP_TOKEN": "<MCP_EMAIL_HTTP_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mailoo": {
      "command": "npx",
      "args": [
        "-y",
        "@bitfloo/mailoo"
      ],
      "env": {
        "MCP_EMAIL_ADDRESS": "<MCP_EMAIL_ADDRESS>",
        "MCP_EMAIL_PASSWORD": "<MCP_EMAIL_PASSWORD>",
        "MCP_EMAIL_IMAP_HOST": "<MCP_EMAIL_IMAP_HOST>",
        "MCP_EMAIL_SMTP_HOST": "<MCP_EMAIL_SMTP_HOST>",
        "MCP_EMAIL_OAUTH2_CLIENT_SECRET": "<MCP_EMAIL_OAUTH2_CLIENT_SECRET>",
        "MCP_EMAIL_OAUTH2_REFRESH_TOKEN": "<MCP_EMAIL_OAUTH2_REFRESH_TOKEN>",
        "MCP_EMAIL_ALERT_WEBHOOK_URL": "<MCP_EMAIL_ALERT_WEBHOOK_URL>",
        "MCP_EMAIL_HTTP_TOKEN": "<MCP_EMAIL_HTTP_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mailoo": {
      "command": "npx",
      "args": [
        "-y",
        "@bitfloo/mailoo"
      ],
      "env": {
        "MCP_EMAIL_ADDRESS": "<MCP_EMAIL_ADDRESS>",
        "MCP_EMAIL_PASSWORD": "<MCP_EMAIL_PASSWORD>",
        "MCP_EMAIL_IMAP_HOST": "<MCP_EMAIL_IMAP_HOST>",
        "MCP_EMAIL_SMTP_HOST": "<MCP_EMAIL_SMTP_HOST>",
        "MCP_EMAIL_OAUTH2_CLIENT_SECRET": "<MCP_EMAIL_OAUTH2_CLIENT_SECRET>",
        "MCP_EMAIL_OAUTH2_REFRESH_TOKEN": "<MCP_EMAIL_OAUTH2_REFRESH_TOKEN>",
        "MCP_EMAIL_ALERT_WEBHOOK_URL": "<MCP_EMAIL_ALERT_WEBHOOK_URL>",
        "MCP_EMAIL_HTTP_TOKEN": "<MCP_EMAIL_HTTP_TOKEN>"
      }
    }
  }
}
```

## Tools

- `list_accounts`: List configured email accounts
- `list_emails`: List emails for an account
- `get_email`: Fetch one email by account name and message ID
- `send_email`: Send an email, with a dryRun preview option

## FAQ

### What do I need to run it?

Node.js 24 or newer and credentials for your mail account, including an app password if your provider requires one.

### Can it be limited to reading?

Yes. Set read-only mode and the toolset to core or minimal.

### What licence is it under?

LGPL-3.0-or-later.

### Where does my mail go?

To the mail servers you configure and to your MCP client and its model provider when you ask for content.

### Is Mailoo - Email MCP Server free?

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

### How do I add Mailoo - Email MCP Server to Claude Code?

Run this command in your terminal: claude mcp add mailoo --env MCP_EMAIL_ADDRESS='<MCP_EMAIL_ADDRESS>' --env MCP_EMAIL_PASSWORD='<MCP_EMAIL_PASSWORD>' --env MCP_EMAIL_IMAP_HOST='<MCP_EMAIL_IMAP_HOST>' --env MCP_EMAIL_SMTP_HOST='<MCP_EMAIL_SMTP_HOST>' --env MCP_EMAIL_OAUTH2_CLIENT_SECRET='<MCP_EMAIL_OAUTH2_CLIENT_SECRET>' --env MCP_EMAIL_OAUTH2_REFRESH_TOKEN='<MCP_EMAIL_OAUTH2_REFRESH_TOKEN>' --env MCP_EMAIL_ALERT_WEBHOOK_URL='<MCP_EMAIL_ALERT_WEBHOOK_URL>' --env MCP_EMAIL_HTTP_TOKEN='<MCP_EMAIL_HTTP_TOKEN>' -- npx -y @bitfloo/mailoo

### What are the best alternatives to Mailoo - Email MCP Server?

The closest alternatives to Mailoo - Email MCP Server are TrendRadar, Ha MCP, Concord MCP, Getmitra and note1.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [TrendRadar](https://ai-powered.com/mcp/trendradar): TrendRadar is an open-source MCP server for communication.
- [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.
- [Getmitra](https://ai-powered.com/mcp/getmitra): Getmitra is an MCP server for communication.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Discord](https://ai-powered.com/mcp/discord-2): Discord is a freemium MCP server for communication.
- [InviteKit Calendar Files](https://ai-powered.com/mcp/invitekit-calendar-files): InviteKit Calendar Files is an MCP server for files and documents.
- [Zoom](https://ai-powered.com/mcp/zoom): Zoom is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/mailoo-email-mcp-server
