Mermoz developer docs

Mermoz keeps your Gmail mailbox on your Mac and lets your own scripts and AI agents work with it. Everything the app does, the command line does, and an MCP server gives agents the same mailbox as native tools. Search and reading are instant and offline. Agents never send mail on their own: a send waits in the Review lane until you approve it in Mermoz.

How the pieces fit

• mermozd, the daemon inside Mermoz.app, is the only process that touches the network and the mailbox database.
• mermoz, the command-line tool, and mermoz mcp, the MCP server, are clients of the daemon over a local Unix socket. Mermoz.app must be running.
• The CLI ships inside the app at /Applications/Mermoz.app/Contents/Resources/mermoz. In Mermoz, open Settings › Developer › Command line tool › Install in PATH to link it as mermoz (into /usr/local/bin or ~/.local/bin).

Pages

• Mermoz CLI reference: every mermoz command, with its --help text and exit codes.
• Mermoz MCP server: add Mermoz to Claude Code, Claude Desktop or Codex; the 29 tools and their parameters.
• Mermoz JSON-RPC protocol: the mermozd socket protocol, for building your own client.

Quick start for agents

mermoz list --status todo --json          # threads waiting on the user
mermoz search "from:marc audit" --json    # instant, offline full-text search
mermoz thread M-1287 --json               # read a whole thread
mermoz draft reply M-1287 --file r.txt    # draft a reply (never sends)
mermoz send dft_8f2c                      # exit 3: waits for the user's approval
claude mcp add mermoz -- mermoz mcp       # or plug the MCP server into Claude Code

Machine-readable summaries: llms.txt, llms-full.txt, server.json (MCP registry format) and /.well-known/mcp.json.