mail-muncher
Filtered, read-only IMAP and Gmail archived to disk as.eml + markdown, served.
Connector by craigjmidwinter · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/craigjmidwinter-mail-muncher
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 4 read · 1 write · 0 delete
- Secrets
- None asked for
- Install scripts
- Not scanned yet
- Runs as
- Docker image
Tools by what they do 5
Read from the source code; the running server may list different tools.
Read 4 · Look things up without changing anything.
list_messageslist_rulesread_messagesearch_messages
Write 1 · Create, change, send or run things.
sync
Tools (5)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
list_messagesList archived messages, newest first. Filter by rule, account, thread or date range. Every summary carries a thread_id, and group_by_thread returns the same messages grouped into conversations.
list_rulesList the configured rules: what each one collects, where it writes, and — read fresh on every call — the domains currently listed in any from_domains_file it uses and the patterns currently in force in any from_regex_file. This is how to see what mail is being subscribed to right now.
read_messageRead one archived message in full: metadata, body text, and the name and size of every attachment. Identify it by the id from a summary, or by a path inside a configured destination directory. Set thread:true to get the whole conversation, oldest message first.
search_messagesSearch archived messages for a string, case-insensitively, across subject, sender, recipients, labels, attachment names and body. Returns summaries newest first, each with a snippet around the hit.
syncFetch new mail once and file it, returning one manifest per account describing exactly what was stored. Only ever adds files; it cannot send, delete or modify mail. Fails immediately if another sync is already running.
Signals
- Stars
- 3
- Forks
- 0
- Open issues
- 0
- Last commit
- Aug 22, 2026 (2 months ago)
- Last release
- Jul 31, 2026 (3 months ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.craigjmidwinter/mail-muncher- Version
- 0.4.0
- Auth
- No auth
- Packages
- oci
ghcr.io/craigjmidwinter/mail-muncher:0.4.0 - License
- MIT
- Repository
- github.com/craigjmidwinter/mail-muncher
- First seen
- Oct 24, 2026
- Last checked
- Oct 25, 2026
More from craigjmidwinter
Cite this page
mail-muncher MCP server. Agent Mart. https://agentmart.dev/connectors/craigjmidwinter-mail-muncher (last updated 2026-10-25)