mcp-server · multimail-dev — Claude Code MCP server for agent email
Gives an AI agent a mailbox with configurable human approval for outgoing mail. Use it to automate email tasks while keeping control over who the agent can contact.
claude mcp add --transport http mcp-server https://mcp.multimail.dev/mcpWhat mcp-server does
Built by multimail-dev, mcp-server connects an AI agent to email through tools for reading messages, composing replies, handling attachments, and scheduling delivery. Messages can be authored in Markdown, while replies retain their conversation threading. Outgoing mail includes a cryptographically signed identity header containing information about the operator and the mailbox's oversight mode.
Mailbox permissions range from read-only access to unrestricted sending and receiving. In gated_send mode, outgoing messages wait for human approval unless their recipients match an approved address or domain pattern. Incoming and outgoing messages pass through content scanning that flags phishing, malware, and prompt injection patterns.
Connect through the remote HTTP endpoint, which uses OAuth during the initial connection, or run the server locally with npx -y @multimail/mcp-server. Local configuration uses MULTIMAIL_API_KEY and MULTIMAIL_MAILBOX_ID. The default gated_send mode keeps newly addressed outgoing mail behind an approval step, which matters when configuring unattended email workflows.
What it helps with
- Filter incoming mail by sender, subject, or message status
- Reply within existing email conversations
- Require operator approval before sending new messages
- Allow automatic delivery to approved addresses or domains
- Inspect signed agent identity and privacy-preserving reputation details
Example prompts for the agent
- Review my inbox and list messages from the specified sender.
- Draft a reply to this email and wait for my approval before sending it.
- Schedule this message for the requested time and check its delivery status.
How to install mcp-server
1Platform CLI: remote server
claude mcp add --transport http mcp-server https://mcp.multimail.dev/mcp2Platform CLI
claude mcp add --env MULTIMAIL_API_KEY=<MULTIMAIL_API_KEY> --env MULTIMAIL_MAILBOX_ID=<MULTIMAIL_MAILBOX_ID> --transport stdio multimail-dev-mcp-server -- npx -y @multimail/mcp-serverReplace <…> with your own values
1Platform CLI: remote server
codex mcp add multimail-dev-mcp-server --url https://mcp.multimail.dev/mcp2Platform CLI
codex mcp add multimail-dev-mcp-server --env MULTIMAIL_API_KEY=<MULTIMAIL_API_KEY> --env MULTIMAIL_MAILBOX_ID=<MULTIMAIL_MAILBOX_ID> -- npx -y @multimail/mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"multimail-dev-mcp-server": {
"url": "https://mcp.multimail.dev/mcp"
}
}
}{
"mcpServers": {
"multimail-dev-mcp-server": {
"command": "npx",
"args": [
"-y",
"@multimail/mcp-server"
],
"env": {
"MULTIMAIL_API_KEY": "<MULTIMAIL_API_KEY>",
"MULTIMAIL_MAILBOX_ID": "<MULTIMAIL_MAILBOX_ID>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"multimail-dev-mcp-server": {
"type": "http",
"url": "https://mcp.multimail.dev/mcp"
}
}
}{
"servers": {
"multimail-dev-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@multimail/mcp-server"
],
"env": {
"MULTIMAIL_API_KEY": "<MULTIMAIL_API_KEY>",
"MULTIMAIL_MAILBOX_ID": "<MULTIMAIL_MAILBOX_ID>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http multimail-dev-mcp-server https://mcp.multimail.dev/mcp2Platform CLI
gemini mcp add -e MULTIMAIL_API_KEY=<MULTIMAIL_API_KEY> -e MULTIMAIL_MAILBOX_ID=<MULTIMAIL_MAILBOX_ID> multimail-dev-mcp-server npx -y @multimail/mcp-serverReplace <…> with your own values
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 mcp-server
How do I install mcp-server in Claude Code?
For remote access, run claude mcp add --transport http mcp-server https://mcp.multimail.dev/mcp. The alternative remote entry is claude mcp add --transport http multimail-dev-mcp-server https://mcp.multimail.dev/mcp. For a local process, run `claude mcp add --env MULTIMAIL_API_KEY=<MULTIMAIL_API_KEY> --env MULTIMAIL_MAILBOX_ID=<MULTIMAIL_MAILBOX_ID> --transport stdio multimail-dev-mcp-server -- npx -y @multimail/mcp-server`.
What does mcp-server do?
It gives an AI agent email tools for reading messages, composing and sending mail, replying in threads, and managing attachments. Mailbox permissions let an operator decide how much autonomy the agent receives.
Does mcp-server require an API key?
Local stdio configuration uses MULTIMAIL_API_KEY and MULTIMAIL_MAILBOX_ID. The remote endpoint handles authentication through OAuth when the client connects for the first time.
Similar MCP servers
All MCP servers for Agent setup: memory, context, orchestration →mcp-server by other authors comes first.
