# mailmcp

> mailmcp is a freemium MCP server for communication. Connects several mailboxes, Gmail to any IMAP, to ChatGPT and Claude with attachments. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, self-hosted, API
- **Website:** https://mailmcp.ai
- **Repository:** https://github.com/kojott/mailmcp-dist
- **MCP Registry name:** ai.mailmcp/mailmcp
- **Categories:** communication, productivity
- **Listing updated:** 2026-11-14

## About

Where the official Gmail and Outlook connectors handle one mailbox each, mailmcp serves several at once under one token: Gmail, Outlook.com, Microsoft 365, iCloud, Fastmail, Yahoo, Zoho, Seznam.cz and any IMAP/SMTP server. The README says official connectors read some attachments and send none, while mailmcp gives one-hour download links and can send attachments from a mailbox, an uploaded file or by forwarding.

Passwords are app passwords encrypted in your browser into a token, and the server keeps one master key and no database. A protection setting can hide verification emails such as one-time codes and password resets from the assistant. Sending is off by default and limited to allowed addresses; bulk actions show a preview first and archive only what the preview listed, deleting nothing.

The prebuilt distribution is commercial and source is not provided. It runs on mailmcp.ai or on your own server through Vercel, Docker, Node 22, or Claude Desktop without a server. The site is bilingual Czech and English.

## Features

- **Multiple mailboxes:** One token reaches several mailboxes across providers.
- **Attachment handling:** One-hour download links and sending from files.
- **Bulk previews:** Preview before archiving up to 50 or 500 messages.
- **Password handling:** App passwords encrypted in the browser; no password database.
- **Verification-mail hiding:** Optional protection hides codes and reset emails.
- **Self-host choices:** Vercel, Docker, Node 22 or Claude Desktop.

## Good for

- Find an invoice in one mailbox and draft it to an accountant in another
- List messages that still need a reply
- Find sent mail that never got an answer
- Clear last month's newsletters after a preview

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mailmcp https://mailmcp.ai/mcp
```

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

```sh
https://mailmcp.ai/mcp
```

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

```json
{
  "mcpServers": {
    "mailmcp": {
      "url": "https://mailmcp.ai/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "mailmcp": {
      "type": "http",
      "url": "https://mailmcp.ai/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mailmcp": {
      "serverUrl": "https://mailmcp.ai/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mailmcp": {
      "type": "http",
      "url": "https://mailmcp.ai/mcp"
    }
  }
}
```

## FAQ

### What does it cost?

Free for 2 mailboxes on mailmcp.ai; a subscription is EUR 49 a year for up to 10 mailboxes; self-hosted licences are EUR 19 (Personal) or EUR 149 (Unlimited) once, excluding VAT on the latter.

### Can the assistant send mail without asking?

No. Sending is off by default and limited to allowed addresses.

### Which providers work?

Gmail, Outlook.com, Microsoft 365, iCloud, Fastmail, Yahoo, Zoho, Seznam.cz and any IMAP/SMTP server.

### Is the source available?

No, the distribution is prebuilt under a commercial licence.

### Is mailmcp free?

mailmcp has a free plan, with paid plans for more usage or features.

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

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

### What are the best alternatives to mailmcp?

The closest alternatives to mailmcp 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/mailmcp
