SMTP Email MCP Server

One local MCP server for every inbox: search, read, send, reply, forward, and organize email across multiple accounts.

Local serverstdio

What is the SMTP Email MCP Server?

SMTP Email MCP Server is an MCP project maintained in the samihalawa/mcp-server-smtp repository. The maintainer describes its purpose as “One local MCP server for every inbox: search, read, send, reply, forward, and organize email across multiple accounts”. Read the project documentation for the complete scope.

Installation

The documented npm package is email-smtp-imap-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares EMAIL_ENV_FILE. 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.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
accounts_listList every configured account and identify the default without exposing credentials.
emails_findSearch by text, sender, recipient, subject, date, read state, flag state, or attachments. Optionally return bodies and attachments.
email_sendSend plain-text or HTML email with CC, BCC, sender aliases, and base64 attachments.
email_respondReply, reply-all, or forward by email UID with threading and optional original attachments.
emails_modifyMark read/unread, flag/unflag, or move messages to another folder.
folders_listList folders with optional total and unread counts.

How to install the SMTP Email MCP Server

{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": [
        "-y",
        "email-smtp-imap-mcp"
      ],
      "env": {
        "EMAIL_ENV_FILE": "/absolute/path/to/your/.env"
      }
    }
  }
}

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

Configuration

VariableDescriptionRequired
EMAIL_ENV_FILEDeclared in the maintainer’s client configuration.Check documentation