Envelope — Claude Code MCP server for agent email
Envelope connects IMAP and SMTP mailboxes so an agent can read and search messages, then prepare replies for human approval.
no license ★ 8 updated 2026-10-15
Open on GitHubWhat Envelope does
Envelope brings connected mailboxes together and gives agents access through MCP or the CLI. An agent can browse messages and search across accounts; a prepared email waits for a person to approve it before sending. The service also supports archiving and snoozing messages.
Sign-in uses a mailbox password or app password, while Gmail can use Google sign-in. Saved credentials are encrypted with a passphrase. For a headless agent, store that passphrase in a file and set ENVELOPE_MASTER_PASSPHRASE_FILE to its path. Without the file, the agent cannot decrypt the saved credentials. On macOS or Linux, install with curl -fsSL https://u1f4e7.com/install.sh | bash, or use brew install tymrtn/u1f4e7/envelope.
What it helps with
- view mail from several accounts in one place
- search messages across connected inboxes
- prepare replies that wait for human approval
- archive messages or snooze them
Example prompts for the agent
- Search all connected inboxes for messages from
[email protected]. - Show me the inbox for
[email protected]. - Draft a reply to message
42and wait for my approval before sending.
How to install Envelope
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Envelope
How do I install Envelope in Claude Code?
On macOS or Linux, run curl -fsSL https://u1f4e7.com/install.sh | bash. Alternatively, install with Homebrew by running brew install tymrtn/u1f4e7/envelope.
What does Envelope do?
It connects existing mailboxes and lets agents access them through MCP or the CLI. An agent's prepared email needs human approval before it is sent.
What must I configure for a headless agent?
Put the passphrase in a file and set ENVELOPE_MASTER_PASSPHRASE_FILE to that file's path. The agent needs it to decrypt saved credentials.