MCPEmails — Claude Code MCP server: email and setup
Connect an agent to Gmail, Outlook, or an IMAP mailbox to search, read, organize, and send email.
claude mcp add --transport http emails https://mcpemails.com/api/mcpWhat MCPEmails does
MCPEmails gives Claude Code email tools through MCP. An agent can search messages, read attachments, move or flag mail, draft replies, and send messages from your address. Scheduled sending is supported too.
Messages are fetched from the provider when requested and are not stored on the server. Outlook and Microsoft 365 connect through Microsoft Graph; Gmail uses IMAP with an app password; other IMAP/SMTP mailboxes are supported. Connect a mailbox and create an API key with the permissions the agent needs. The npx setup requires that key.
What it helps with
- search a mailbox for matching messages
- read an email and its attachments
- move or flag selected messages
- send mail from a connected address
- schedule a message for later delivery
Example prompts for the agent
- Find messages about the login failure and show who sent them.
- Read the latest email from the team and extract its attachment text.
- Draft a reply to the latest message and send it from my address.
How to install MCPEmails
1Platform CLI: remote server
claude mcp add --transport http emails https://mcpemails.com/api/mcp2Platform CLI
claude mcp add --env MCPEMAILS_API_KEY=<MCPEMAILS_API_KEY> --transport stdio mcpemails -- npx -y mcpemailsReplace <…> with your own values
1Platform CLI: remote server
codex mcp add mcpemails --url https://mcpemails.com/api/mcp2Platform CLI
codex mcp add mcpemails --env MCPEMAILS_API_KEY=<MCPEMAILS_API_KEY> -- npx -y mcpemailsReplace <…> with your own values
Config file
{
"mcpServers": {
"mcpemails": {
"url": "https://mcpemails.com/api/mcp"
}
}
}{
"mcpServers": {
"mcpemails": {
"command": "npx",
"args": [
"-y",
"mcpemails"
],
"env": {
"MCPEMAILS_API_KEY": "<MCPEMAILS_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcpemails": {
"type": "http",
"url": "https://mcpemails.com/api/mcp"
}
}
}{
"servers": {
"mcpemails": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcpemails"
],
"env": {
"MCPEMAILS_API_KEY": "<MCPEMAILS_API_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http mcpemails https://mcpemails.com/api/mcp2Platform CLI
gemini mcp add -e MCPEMAILS_API_KEY=<MCPEMAILS_API_KEY> mcpemails npx -y mcpemailsReplace <…> 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 MCPEmails
How do I install MCPEmails in Claude Code?
Run claude mcp add --transport http emails https://mcpemails.com/api/mcp. Then connect a mailbox and choose the agent's permissions.
What does MCPEmails do?
It gives an agent tools to search, read, organize, and send email through a connected mailbox. Messages are fetched when requested rather than stored on the server.
Which email providers work with MCPEmails?
Outlook and Microsoft 365 connect through Microsoft Graph, Gmail through IMAP, and other IMAP/SMTP mailboxes are supported.
