Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Postbode

A fast, simple IMAP mail client for powerusers and developers, with rules that keep your mailbox clean. Postbode syncs your mail into a local store, moves it into folders and deletes transient mail such as sign-in codes and magic links once you no longer need it. Agents can propose rules; you approve them.

postbode gui opens a keyboard-driven mail window; everything also works from the command line. An MCP server follows.

Quickstart

cargo install --git https://github.com/pataar/postbode
postbode account add      # asks for host, user and password, then tests the login
postbode sync             # first sync of every folder
postbode list             # newest mail in INBOX
postbode gui              # the mail window

Add rules to rules.toml next to config.toml, in ~/.config/postbode/ on Linux or ~/Library/Application Support/postbode/ on macOS:

[[rules]]
name = "purge sign-in codes"
match.subject = { regex = "(?i)sign.?in|verification code|magic link" }
match.older_than = "1h"
match.seen = true
actions = ["delete"]
postbode rules test       # dry run: what would each rule do?
postbode run              # keep syncing, apply rules, notify on new mail

Deleted mail is kept as .eml for 30 days: postbode trash list and postbode trash restore FILE.

Postbode is licensed under MIT or Apache-2.0, at your option.