Email

An MCP server that sends and reads emails via SMTP/IMAP with multi-account support and folder management.

javascript

GitHub Stars

javascript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "samihalawa-email-smtp-imap-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "email-smtp-imap-mcp"
      ],
      "env": {
        "EMAIL_ACCOUNTS_JSON": "{\"work\":{\"smtp\":{\"host\":\"smtp.gmail.com\",\"port\":587,\"user\":\"your@gmail.com\",\"password\":\"app-password\"},\"imap\":{\"host\":\"imap.gmail.com\",\"port\":993},\"default_from_name\":\"Your Name\",\"sender_emails\":[\"your@gmail.com\"]}}",
        "DEFAULT_EMAIL_ACCOUNT": "work"
      }
    }
  }
}

You can run an MCP server that handles email sending via SMTP and reading via IMAP, with multi-account support, search, threading, and folder organization. This guide shows you how to install, configure, and use the Email MCP Server so you can send, read, and manage emails from a single, local MCP endpoint.

How to use

To use the Email MCP Server, connect your MCP client to the local MCP instance. You can manage multiple email accounts, send HTML emails with attachments, search for messages, reply or forward with proper threading, and organize your mailbox by marking read/unread, archiving, and flagging messages. You can also list all folders to navigate your mailbox structure.

How to install

Prerequisites: ensure you have Node.js installed on your machine. You will use npm or npx to run the MCP server.

Install and run the MCP server using the following commands.

# Quick run without global install
npx -y email-smtp-imap-mcp

# Or install globally and run
npm install -g email-smtp-imap-mcp

Additional details

Configuration is done by providing an MCP server entry that launches the Email MCP Server locally. You configure your email accounts, including SMTP and IMAP settings, and specify the default account and sender details.

Available tools

emails_find

Search emails with flexible filters (sender, subject, date, attachments, etc.)

emails_modify

Mark as read/unread, flag, archive, or move emails

email_send

Send new emails with HTML content and attachments

email_respond

Reply or forward emails with proper threading

folders_list

List all available email folders

Built by

VeilStrat

AI signals for GTM teams