Agent Email — Claude Code MCP server: email tools and setup
Connect an agent to Outlook or Gmail to search mail, prepare replies, and manage messages through MCP.
claude mcp add email-agent-mcp -- npx -y email-agent-mcpWhat Agent Email does
Agent Email gives MCP-compatible agents tools for working with a mailbox. They can list and read messages, search conversations, create or edit drafts, reply, and send email. For Outlook, the server can also label messages, change their read state, and move them between folders.
Sending is gated by an allowlist, so the agent cannot send mail until you configure permitted recipients. Deletion is disabled by default and requires explicit opt-in. Start npx -y email-agent-mcp to open the setup wizard for OAuth and mailbox selection. In Claude Code, add the server with claude mcp add email-agent-mcp -- npx -y email-agent-mcp.
What it helps with
- search a mailbox for a particular conversation
- prepare a reply without sending it
- send mail only to approved recipients
- mark messages as read or move them to folders
- apply labels to Outlook messages
Example prompts for the agent
- Find the conversation about the release and show me its messages.
- Draft a reply to this email, but leave it unsent.
- Mark this message as read and move it to the processed folder.
How to install Agent Email
Platform CLI
claude mcp add email-agent-mcp -- npx -y email-agent-mcpPlatform CLI
codex mcp add agent-email -- npx -y email-agent-mcpConfig file
{
"mcpServers": {
"agent-email": {
"command": "npx",
"args": [
"-y",
"email-agent-mcp"
]
}
}
}Config file
{
"servers": {
"agent-email": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"email-agent-mcp"
]
}
}
}Platform CLI
gemini mcp add agent-email npx -y email-agent-mcpStep 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 Agent Email
How do I install Agent Email in Claude Code?
Run claude mcp add email-agent-mcp -- npx -y email-agent-mcp. Then start npx -y email-agent-mcp and complete the OAuth and mailbox setup.
What does Agent Email do?
It connects an MCP-compatible agent to Outlook or Gmail. The agent can search and read mail, prepare drafts, and perform supported message actions.
How does Agent Email control outgoing mail?
Configure an allowlist of permitted recipients before enabling sending. Message deletion stays disabled unless you explicitly opt in.
