mail-mcp MCP Server

Most email MCP servers only do IMAP reads. This one does everything: read, search, send, reply, forward, bulk operations, Microsoft Graph API, and Exchange Web Services — with real OAuth2…

Local serverstdio

What is the mail-mcp Server?

mail-mcp is an MCP project maintained in the tecnologicachile/mail-mcp repository. The maintainer describes its purpose as “Most email MCP servers only do IMAP reads. This one does everything: read, search, send, reply, forward, bulk operations, Microsoft Graph API, and Exchange Web…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using ./target/release/mail-mcp. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares MAIL_IMAP_DEFAULT_HOST, MAIL_IMAP_DEFAULT_USER, MAIL_IMAP_DEFAULT_PASS, MAIL_SMTP_DEFAULT_HOST, MAIL_SMTP_DEFAULT_PORT, MAIL_SMTP_DEFAULT_USER, MAIL_SMTP_DEFAULT_PASS, MAIL_SMTP_DEFAULT_SECURE, MAIL_IMAP_WRITE_ENABLED, MAIL_SMTP_WRITE_ENABLED. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

How to install the mail-mcp Server

{
  "mcpServers": {
    "mail": {
      "command": "./target/release/mail-mcp",
      "env": {
        "MAIL_IMAP_DEFAULT_HOST": "imap.gmail.com",
        "MAIL_IMAP_DEFAULT_USER": "you@gmail.com",
        "MAIL_IMAP_DEFAULT_PASS": "your-app-password",
        "MAIL_SMTP_DEFAULT_HOST": "smtp.gmail.com",
        "MAIL_SMTP_DEFAULT_PORT": "587",
        "MAIL_SMTP_DEFAULT_USER": "you@gmail.com",
        "MAIL_SMTP_DEFAULT_PASS": "your-app-password",
        "MAIL_SMTP_DEFAULT_SECURE": "starttls",
        "MAIL_IMAP_WRITE_ENABLED": "true",
        "MAIL_SMTP_WRITE_ENABLED": "true"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
MAIL_IMAP_DEFAULT_HOSTDeclared in the maintainer’s client configuration.Check documentation
MAIL_IMAP_DEFAULT_USERDeclared in the maintainer’s client configuration.Check documentation
MAIL_IMAP_DEFAULT_PASSDeclared in the maintainer’s client configuration.Check documentation
MAIL_SMTP_DEFAULT_HOSTDeclared in the maintainer’s client configuration.Check documentation
MAIL_SMTP_DEFAULT_PORTDeclared in the maintainer’s client configuration.Check documentation
MAIL_SMTP_DEFAULT_USERDeclared in the maintainer’s client configuration.Check documentation
MAIL_SMTP_DEFAULT_PASSDeclared in the maintainer’s client configuration.Check documentation
MAIL_SMTP_DEFAULT_SECUREDeclared in the maintainer’s client configuration.Check documentation
MAIL_IMAP_WRITE_ENABLEDDeclared in the maintainer’s client configuration.Check documentation
MAIL_SMTP_WRITE_ENABLEDDeclared in the maintainer’s client configuration.Check documentation