An email client for AI agents. Filtered, read-only Gmail delivered to disk as .eml + markdown, and served over MCP.
View on GitHub ↗Homepage ↗Give a program its own read-only mailbox, filtered down to exactly the mail it asked for, delivered as files on disk.
mail-muncher pulls messages from a mail provider, evaluates each one against ordered rules, and writes the matches to a directory — byte-faithful .eml, and optionally a markdown rendering with the headers as YAML frontmatter, the body as text, and attachments extracted alongside. A rule can take its filter input from a plain text file that some other program owns, which mail-muncher re-reads at the start of every cycle. That other program changes one line in that file, and the very next cycle delivers different mail — no config edit, no restart, no redeploy.
It reads from any IMAP mailbox — Gmail, Fastmail, iCloud, Proton Bridge, a work account, your own server — or from Gmail's API with a read-only OAuth scope. It runs one-shot for cron, or as a polling daemon, or as a stdio MCP server an agent can query directly. Every mode emits the same machine-readable manifest of what it did, and no mode ever writes to your mailbox.
Pick one before you install anything. Both are supported, and everything downstream — rules, formats, filenames, the archive layout, the MCP tools — is identical either way.
provider: imap provider: gmail --- --- --- Setup time ~2 min ~10 min in the Google Cloud Console What you register nothing your own Google Cloud project and Desktop-app OAuth client Credential an app password from your provider's own settings page an OAuth token, scope gmail.readonly How wide that credential is a full mail credential. An app password can send and de
From the project README.
Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:
[](https://mcp.liqiwa.com/s/craigjmidwinter--mail-muncher.html)
Render agent-written Markdown as a live local page, and send the human's click back to the agent as typed data. Human-in-the-loop approval gates for coding agents.
mkpoli/gmail-mcpMulti-account Gmail MCP server on Cloudflare Workers — one deployment, one Google sign-in per connection, any MCP client
vshulcz/deja-vuYour agents already solved this. deja finds it — retroactive search and MCP recall over the session logs your coding agents already wrote. Cross-agent, SSH-portable, one zero-dep binary, fully local.
Evermemoai/evermemoA tiny, universal memory engine for humans and AI agents — CLI, HTTP API, MCP server, and shared memory hub in one small Go binary
mkk2026/agentregDNS for AI agents: a self-hosted registry to register, discover, and health-check MCP agents. One Go binary.
Naveen-chava/metabase-mcpMetabase MCP server for AI Agents. Authenticate with a browser session cookie, no API key required.
The top new MCP servers of the week, every Monday. No spam, unsubscribe anytime.