# mcp4mail

> mcp4mail is an open-source MCP server for communication. Connect any IMAP mailbox so Claude, ChatGPT or Grok can search and read your mail. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Web, self-hosted, API
- **Website:** https://mcp4mail.online
- **Repository:** https://github.com/jchsoft/mcp4mail
- **MCP Registry name:** online.mcp4mail/mcp4mail
- **Categories:** communication, productivity
- **Listing updated:** 2026-11-16

## About

mcp4mail is built around a cautious default: every connected mailbox is read-only, so an assistant can list, search and read but cannot send, move, delete or even mark a message as read. The owner can switch on changes per mailbox and then tick which actions are allowed, such as flagging, moving, drafting, sending or trashing. Anything the assistant wants to send waits until a human presses Send in an email the service sends back.

You add a mailbox with an app password rather than your main password, and the AI client authorises through OAuth 2.1, never seeing that password. It works with Gmail, iCloud, Outlook, Seznam, Fastmail, Zoho and other IMAP providers, and one connector can hold several mailboxes and open attachments. The hosted service stores the password encrypted, while the open-source project can be self-hosted with docker compose so credentials stay on your own machine.

The README offers an unusual note on provenance: the project is primarily developed by AI agents orchestrated through a task tool, with humans writing briefs and reviewing pull requests.

## Features

- **Read-only by default:** Assistants can list, search and read until you allow changes.
- **Per-action permissions:** Tick flagging, moving, drafting, sending or deleting.
- **Send approval:** Outgoing mail waits for a human to press Send.
- **Attachment access:** Download attachments via short-lived links or inline up to 5 MB.
- **Multiple mailboxes:** Several accounts in one connector.
- **Self-hostable:** Run it yourself with docker compose.
- **Audit log:** Records each call by client and tool.

## Good for

- Asking which emails still need a reply
- Finding an order confirmation and delivery date
- Summarising a long thread across folders
- Looking up contacts you have corresponded with

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp4mail https://mcp4mail.online/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp4mail.online/mcp
```

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

```json
{
  "mcpServers": {
    "mcp4mail": {
      "url": "https://mcp4mail.online/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp4mail": {
      "type": "http",
      "url": "https://mcp4mail.online/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp4mail": {
      "serverUrl": "https://mcp4mail.online/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp4mail": {
      "type": "http",
      "url": "https://mcp4mail.online/mcp"
    }
  }
}
```

## Tools

- `list_mail_accounts`: List connected mail accounts
- `get_mail_account`: Show one account's connection details (never its password)
- `list_folders`: List an account's folders
- `search_messages`: Search by subject, sender, recipients, attachment names and date
- `get_message`: Read one message
- `get_attachment`: Download an attachment
- `search_contacts`: Find addresses you have corresponded with
- `get_outgoing_status`: Check status of outgoing messages

## FAQ

### Is it free?

The site calls it free and open source.

### Does the AI see my password?

No. You enter an app password and the client connects through OAuth 2.1.

### Can the assistant send mail on its own?

No. send_message prepares an email that goes out only after a human presses Send.

### Which providers work?

Gmail, iCloud, Outlook, Fastmail, Zoho, Seznam and any IMAP mailbox.

### Is mcp4mail free?

Yes. mcp4mail is open source, so you can use and self-host it for free.

### How do I add mcp4mail to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp4mail https://mcp4mail.online/mcp

### What are the best alternatives to mcp4mail?

The closest alternatives to mcp4mail are Ha MCP, Concord MCP, note1, BoardAgent and Callout.

## Alternatives

- [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.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.

---
Source: https://ai-powered.com/mcp/mcp4mail
