Postmesh syncs mail to local storage and exposes messages through a structured CLI and JSON interface for scripts, tools, and agents.
It keeps a local copy of your mail up to date, normalizes message data across providers, and lets other tools query that data through explicit filters.
Authorize a supported email account and keep account sync state locally.
Store mail in a local normalized database so queries do not call the provider every time.
Use explicit filters and JSON output from scripts, tools, and agents.
Postmesh is not a hosted inbox service. It is a local interface for reading email data programmatically.
Agents can build on it, but Postmesh does not need to interpret vague instructions.
Works with Gmail and Outlook while keeping the interface centered on email data.
Postmesh syncs provider mail into local storage so queries can run against a stable local data shape.
Subject, body preview, sender, recipients, timestamps
Message relationships grouped by conversation
Provider-specific organization normalized for querying
Connected accounts, read state, provider ids, and sync state
Filter by sender, recipient, subject, body text, date range, read state, folder, labels, and full-text search.
Results are paginated with cursors so tools can safely walk through larger result sets.
The agent decides what data it needs, builds a structured query, and calls Postmesh. Postmesh returns matching mail as JSON.
Queries run against local storage. Tools do not need to repeatedly call provider APIs, agents do not need to scrape inbox UIs, and data remains available in local developer environments.
Query local storage instead of waiting on a remote mail API for every lookup.
Give tools and agents a stable interface rather than brittle browser workflows.
Different providers can be queried through one normalized local data layer.
Install Postmesh, connect an account, sync mail, and query messages with explicit filters.
curl -fsSL https://postmesh.pages.dev/install.sh | sh