Imaplane

A control plane so agents can use IMAP — anything you allow, not everything.

Get it on GitHub Quick start

Local-first. You start it on purpose.

What it is

Local-first little tool Runs on your machine. Loopback by default. Not a SaaS.
IMAP for agents iCloud / Apple Mail presets plus generic IMAP. Agents organise mail you let them touch.
MCP + HTTP + OpenAPI Same plane, three doors. Mailbox passwords never leave the box.

Can / can’t

Can

Read, search, list folders
Move mail and set flags
File-based rules and optional sweeps
Send — only if you opt in

Can’t (by default)

Send mail until you turn SMTP on
Bind the public internet
Invent a folder tree or clobber Important
See your Apple password from MCP

Quick start

git clone https://github.com/danb0nd/imaplane
cd imaplane
npm install && npm run build
npx imaplane init
npm start
grok mcp add imaplane -- node "$(pwd)/dist/mcp.js"

HTTP owns IMAP. MCP is a stdio client of http://127.0.0.1:8787/v1. Remote agents: Tailscale Serve or an SSH tunnel — see the README. Not the core product.

Got a sharper pitch, a bug, or a feature wish? Help make it better