Local-first, read-only MCP server for recall over your Gmail: search, contacts, threads, digests.
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"io-github-alunsoldantarctica-mail-index": {
"args": [
"-y",
"mail-index"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
mail-index downloads a preview of your whole inbox to your machine, then smartly fetches the full text of the messages that matter as you use it. That local index lets your AI agent run true summarization and recall over your entire mailbox — instead of being trapped behind Gmail's search bar.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y 'mail-index' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked mail-index against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in other
Pi Coding Agent extension (CLI-first) — routes bash/read/grep/find/ls through lean-ctx CLI for strong token savings. Optional MCP bridge can register advanced tools.
Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 60-95% fewer tokens, same answers. Library, proxy, MCP server.
97% token reduction for AI coding sessions — zero deps, 21 languages, MCP server
Autonomous spec-to-product coding-agent CLI with an MCP server exposing 34 tools over stdio.
MCP Security Weekly
Get CVE alerts and security updates for io.github.alunsoldantarctica/mail-index and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
mail-index downloads a preview of your whole inbox to your machine, then smartly fetches the full text of the messages that matter as you use it. That local index lets your AI agent run true summarization and recall over your entire mailbox — instead of being trapped behind Gmail's search bar.
It works through a local MCP server, so any agent (Claude, Codex, any MCP
client) can query it. Local-first — the index never leaves your machine.
Read-only by default — it never sends or mutates your mail unless you
explicitly opt into archive + label edits (a least-privilege gmail.modify
re-auth; never send or delete). See ADR-0007.
Ask a vague question → one local MCP call → ranked, snippet-first answer.
Interactive version →
Status: v1.0 — published. Progressive sync, the correspondence graph, the interest engine, curation, the full 23-tool MCP surface, and the write-back loops are built and tested — and
mail-indexis live on npm with a.mcpbbundle. Still in progress: the bundled Option A OAuth client and signed one-click installers. Architecture lives in docs/PLAN.md; start with docs/INSTALL.md.
[!TIP] New in v1.4 — opt-in mailbox writes + human-readable labels. mail-index can now archive a message and edit its labels directly on Gmail — via the
archive/labelCLI commands and thearchive_message/modify_labelsMCP tools, on both the gog and gws adapters. It stays read-only by default: writes are unreachable until you opt in with a least-privilegegmail.modifygrant (never send or delete) — enable per account withmail-index setup --account <email> --enable-writesor the bundledscripts/enable-writes.sh. Labels now render as their human names everywhere (the index caches Gmail's label catalogue and resolvesLabel_3546…→ "Expedition Insure" in both directions), and you can pass a friendly label name tolabel --add/--remove. The local-only / zero-egress guarantee is unchanged. See ADR-0007.