Stop searching.
Start understanding.
An open-source CLI and MCP server that gives your AI agent deep, persistent email understanding—who matters, what relationships exist, and what’s happening in your life and business.
Every agent session starts from zero.
Gmail MCP servers let agents read individual messages. But understanding—knowing who matters, what relationships exist, what’s happening—requires investigation, cross-referencing, and memory.
Agents can’t do that in a single search.
What your agent gets
- search_emails Search Gmail by any query
- read_email Read the full body of a message
- build_profile Deep investigation—extract people and context from Gmail
- build_status Check progress of a running investigation
- who_is Look up a person from cached knowledge
- about_me What the agent knows about you
- get_candidates Review structured results from the latest build
- profile_health Check freshness and coverage of cached profiles
- reset_profile Wipe generated data and start fresh
- check_auth Verify Gmail authentication status
How it works
Install
pip install deep-email
Authenticate
deep-email auth
Your agent connects
The CLI handles auth and setup. The MCP server gives your agent 10 tools for searching, reading, and building persistent knowledge. No configuration needed.
Works with Claude Code, Cursor, Codex, GitHub Copilot, Windsurf, Gemini CLI, and 40+ other MCP-compatible agents.
Example
“Find all my investors.”
- Agent searches for term sheets, fund communications, board emails
- Follows leads—reads specific messages, cross-references names
- Builds a complete investor table across 3 funding rounds
Next session: already knows. No re-searching.