io.github.AIWerk/mcp-server-imap MCP Server

Name: io.github.AIWerk/mcp-server-imap MCP Server
Author: io.github.AIWerk

io.github.AIWerk/mcp-server-imap

Repository Registry

What is the io.github.AIWerk/mcp-server-imap MCP server?

Email tools for any IMAP/SMTP provider: list, read, search, send, and manage messages.

How to install io.github.AIWerk/mcp-server-imap

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

IMAP_HOST
required
IMAP server hostname (e.g. imap.gmail.com).
IMAP_USER
required
IMAP account username / email address.
IMAP_PASS
required
secret
IMAP account password or app-specific password.
SMTP_HOST
SMTP server hostname, required to send email.
SMTP_USER
SMTP account username (defaults to IMAP_USER if unset).
SMTP_PASS
secret
SMTP account password (defaults to IMAP_PASS if unset).

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-imap": {
      "command": "npx",
      "args": [
        "-y",
        "@aiwerk/mcp-server-imap"
      ],
      "env": {
        "IMAP_HOST": "<YOUR_IMAP_HOST>",
        "IMAP_USER": "<YOUR_IMAP_USER>",
        "IMAP_PASS": "<YOUR_IMAP_PASS>",
        "SMTP_HOST": "<YOUR_SMTP_HOST>",
        "SMTP_USER": "<YOUR_SMTP_USER>",
        "SMTP_PASS": "<YOUR_SMTP_PASS>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server-imap": {
      "command": "npx",
      "args": [
        "-y",
        "@aiwerk/mcp-server-imap"
      ],
      "env": {
        "IMAP_HOST": "<YOUR_IMAP_HOST>",
        "IMAP_USER": "<YOUR_IMAP_USER>",
        "IMAP_PASS": "<YOUR_IMAP_PASS>",
        "SMTP_HOST": "<YOUR_SMTP_HOST>",
        "SMTP_USER": "<YOUR_SMTP_USER>",
        "SMTP_PASS": "<YOUR_SMTP_PASS>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server-imap": {
      "command": "npx",
      "args": [
        "-y",
        "@aiwerk/mcp-server-imap"
      ],
      "env": {
        "IMAP_HOST": "<YOUR_IMAP_HOST>",
        "IMAP_USER": "<YOUR_IMAP_USER>",
        "IMAP_PASS": "<YOUR_IMAP_PASS>",
        "SMTP_HOST": "<YOUR_SMTP_HOST>",
        "SMTP_USER": "<YOUR_SMTP_USER>",
        "SMTP_PASS": "<YOUR_SMTP_PASS>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mcp-server-imap": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@aiwerk/mcp-server-imap"
      ],
      "env": {
        "IMAP_HOST": "<YOUR_IMAP_HOST>",
        "IMAP_USER": "<YOUR_IMAP_USER>",
        "IMAP_PASS": "<YOUR_IMAP_PASS>",
        "SMTP_HOST": "<YOUR_SMTP_HOST>",
        "SMTP_USER": "<YOUR_SMTP_USER>",
        "SMTP_PASS": "<YOUR_SMTP_PASS>"
      }
    }
  }
}

Claude Code

claude mcp add mcp-server-imap --env IMAP_HOST=<YOUR_IMAP_HOST> --env IMAP_USER=<YOUR_IMAP_USER> --env IMAP_PASS=<YOUR_IMAP_PASS> --env SMTP_HOST=<YOUR_SMTP_HOST> --env SMTP_USER=<YOUR_SMTP_USER> --env SMTP_PASS=<YOUR_SMTP_PASS> -- npx -y @aiwerk/mcp-server-imap