Glassmail

AI agents

Codex CLI

Add Glassmail to Codex with one command, then ask Codex about your mail.

All setup guides

Steps

  1. In Glassmail, open Settings › Agents and turn on Allow AI agents to read my mail.
  2. Click Set Up next to Codex CLI. Glassmail adds a [mcp_servers.glassmail] section to ~/.codex/config.toml, after backing the file up.
  3. Start a new Codex session and ask about your mail.

Or in Terminal

codex mcp add glassmail -- /Applications/Glassmail.app/Contents/MacOS/Glassmail --mcp

Or add it to ~/.codex/config.toml yourself:

[mcp_servers.glassmail]
command = "/Applications/Glassmail.app/Contents/MacOS/Glassmail"
args = ["--mcp"]

What the agent can do

What stays private

If it doesn’t work

Codex doesn’t list any Glassmail tools

“Glassmail isn’t sharing mail right now”

Turn on Allow AI agents to read my mail in Glassmail › Settings › Agents.

“Glassmail isn’t open”

Reading works with Glassmail closed. Changing mail, downloading an email whose text hasn’t arrived yet, and reading an attachment need Glassmail open, because Glassmail does those, not the agent.

The agent can’t find mail you know is there

Check Hide from agents in Settings › Agents. Mail in a hidden account, folder or from a hidden sender is left out of every answer.

Still stuck? Write to hi@glassmail.app and a person replies, usually within a day. Never send us a password.

Other guides

Glassmail is downloading

  1. 1Open Glassmail.dmg from your Downloads (bottom right of the Dock, or in Finder › Downloads).
  2. 2In the window that opens, drag Glassmail onto the Applications folder.
  3. 3Open Glassmail from Applications or Launchpad, and click Open if your Mac asks.

Download didn’t start? Try again · Step-by-step install guide