mcpField
M
mailroom

mailroom

Local
github.com/darrylmosherCommunication
Repository

About mailroom

mailroom is a self-hosted gateway for connecting one person’s iCloud mailbox to an AI assistant, with a local index plus REST, CLI, and MCP access. It emphasizes tiered permissions, draft-first sending, and safeguards for untrusted email content.

Key features

  1. 01Local mailbox index and full-text search
  2. 02Restrict actions with key tiers
  3. 03Save outgoing messages as drafts by default
  4. 04Strip hidden text and label content untrusted
  5. 05Undo mailbox actions
  6. 06REST API and JSON CLI

Use cases

  1. 01Search and triage iCloud mail
  2. 02Draft replies for human review
  3. 03Check sender verification and hidden text
  4. 04Wake an agent with mailbox change notifications

MCP support

The included MCP server connects to mailroom over HTTP and registers only the tools allowed by the API key’s permission tier.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "darrylmosher-mailroom": {
      "command": "uvx",
      "args": [
        "mailroom-icloud"
      ],
      "env": {
        "MAILROOM_URL": "<MAILROOM_URL>",
        "MAILROOM_KEY": "<MAILROOM_KEY>"
      }
    }
  }
}
Run commanduvx mailroom-icloud
Environment variables to set
MAILROOM_URLBase URL of your mailroom server (e.g. http://127.0.0.1:8420 or your tailnet HTTPS URL)
MAILROOM_KEYSecretYour mailroom API key; the tier it grants (read/write/send) decides which tools exist

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypimailroom-icloud1.1.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

The maintainer has not added details yet. Check the README in the repository.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.