Imaplane

A local control plane for IMAP — agents, scripts, and apps you build. 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.
Also an API for your own apps Call the same local HTTP + OpenAPI plane from scripts, backends, and products you build — not just chat agents.
MCP + HTTP + OpenAPI Same plane, three doors. Mailbox passwords never leave the machine.

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
# agents: grok mcp add imaplane -- node "$(pwd)/dist/mcp.js"
# apps:   curl -H "Authorization: Bearer $BRIDGE_TOKEN" http://127.0.0.1:8787/v1/health

HTTP owns IMAP. Point any program at http://127.0.0.1:8787/v1 with your bridge token (OpenAPI in the repo). MCP is a thin stdio client of that same API. Remote access: Tailscale Serve or an SSH tunnel — see the README.

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