01
TUI
A full inbox without leaving your terminal — read, star, search, compose.
wipplank tuiFOR YOUR KEYBOARD TERMINAL-FIRST EMAIL
EMAIL FOR
HUMANS & AGENTS.
IMAP and Gmail, multiple accounts, from your terminal. Human-friendly output, --json on everything, and an MCP server so your agent can read and send on your behalf. No boring email allowed.
$ uv run wipplank --backend demo check # zero setup, try it now
$ uv run wipplank party # no boring email
HUMAN ↔ AGENTEMAIL IN BOTH DIRECTIONS
01 / HOW IT WORKS
Zero to inbox in
five commands.
Try it with the demo backend — no account needed. Connect your real mailbox when you are ready. First sends are dry-runs, so nothing leaves by accident.
$ uv sync --python 3.11 --all-extras # install
$ uv run wipplank --backend demo check # try it, zero setup
$ uv run wipplank auth login --account work --preset fastmail # connect your mailbox
$ uv run wipplank check # your inbox
$ uv run wipplank send --to bob@example.com -s "hi" --body "hello" --dry-run # safe first send
02 / THE NAME
wipplank.
seesaw
↔
Email goes
both ways.
Send. Receive. Reply. Repeat. One side goes up while the other comes down. Wipplank is a simple name for a two-way conversation.
send↔receive
03 / ONE SYSTEM
One email system.
Three ways to use it.
The same engine serves a person at a keyboard, a script in cron, and an agent running in the background.
02
CLI
Composable commands for scripts and automation. --json on everything.
wipplank send --dry-run --jsonFOR YOUR SCRIPTS03
MCP
Controlled agent access: list, read, search, send, reply — plus backend status.
wipplank mcpFOR YOUR AGENTS04 / UNDER THE HOOD
Built for the
terminal age.
Wipplank keeps the core email engine independent from how you interact with it. Stable message IDs, a fast local cache, and read-only-by-default access keep every interface honest.
WIPPLANKEMAIL ENGINE
CLIscripts
TUIhumans
MCPagents
01
Multi-account
IMAP and Gmail side by side, switched with --account.
02
Safe reads
BODY.PEEK only. Checking mail never marks it read.
03
Keyring secrets
Passwords and tokens live in the OS keyring, never on disk.
04
Agent-native
Every command speaks --json; the MCP server speaks agent.
05
Fast cache
Repeat checks served locally. --fresh when you want live.
06
PGP
Body-only sign and encrypt, verify footer on read.
07
Compose kit
Templates, signatures, drafts, saved searches.
08
Fun included
Moods, celebrations, Boredom Patrol. Try wipplank party.
05 / IN YOUR TERMINAL
checkreadsearchsendreplyforwardmarksavedattachtemplatedrafttuimcppartyauth
OPEN SOURCE
Give your terminal
an inbox.
For terminal dwellers, script automators, and agent operators. MIT-licensed and tested — no boring email allowed.