IMAP Email

Connects to IMAP/SMTP providers to read, search, compose, and manage emails via MCP-enabled clients.

other

GitHub Stars

other

Language

4 months ago

First Indexed

2 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": {
    "jdickey1-imap-email-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "imap-email-mcp"
      ],
      "env": {
        "IMAP_TLS": "<IMAP_TLS>",
        "IMAP_HOST": "imap.example.com",
        "IMAP_PORT": "<IMAP_PORT>",
        "IMAP_USER": "your-email@example.com",
        "SMTP_HOST": "<SMTP_HOST>",
        "SMTP_PORT": "<SMTP_PORT>",
        "SMTP_SECURE": "<SMTP_SECURE>",
        "IMAP_PASSWORD": "your-app-password"
      }
    }
  }
}

This MCP Server enables Claude Code, Claude Desktop, Cursor, and other MCP-compatible tools to read, search, compose, and manage emails by connecting to any IMAP/SMTP provider. It brings email capabilities directly into your AI workflows, so you can read your inbox, draft messages, search by content, and send emails without leaving your AI environment.

How to use

You will connect your email provider to an MCP client by adding this MCP server as an active tool. Once configured, you can ask your AI to check your inbox, search for messages from a specific sender, draft emails, or send messages directly through SMTP. Use natural language prompts like “Check my inbox for unread emails,” “Search emails from john@example.com,” or “Create a draft to sarah@example.com about the meeting.” The MCP tools cover folders, emails, drafts, and sending actions, so you can manage mail entirely through your AI assistant.

How to install

# Prerequisites: ensure you have Node.js and npm installed
node -v
npm -v

# Option 1: Install globally (recommended for quick access)
npm install -g imap-email-mcp
imap-email-mcp

# Option 2: Clone the project and run locally
# (If you prefer to run from source, use these commands)
git clone https://github.com/jdickey1/imap-email-mcp.git
cd imap-email-mcp
npm install
node index.js

Additional setup notes

Before using the MCP server, provide your email credentials securely. The server expects the following environment variables to be set for the connection: IMAP_USER, IMAP_PASSWORD, and IMAP_HOST. You can set these in your MCP client configuration. Use app-specific passwords for your email provider and avoid using your main account password.

Available tools

list_folders

List all email folders/mailboxes

list_emails

List emails with optional filtering

get_email

Get full email content by UID

search_emails

Search by subject, sender, or body

list_drafts

List all draft emails

get_draft

Get a specific draft by UID

create_draft

Create a new email draft

update_draft

Update an existing draft

send_email

Send an email directly

delete_email

Delete an email by UID

Built by

VeilStrat

AI signals for GTM teams