English Français العربية

io.github.AIWerk/mcp-server-imap

Official registry Search and web

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

Source code Website

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @aiwerk/mcp-server-imap
Claude Code 
claude mcp add mcp-server-imap -e 'IMAP_HOST=<IMAP_HOST>' -e 'IMAP_USER=<IMAP_USER>' -e 'IMAP_PASS=<your imap_pass>' -e 'SMTP_HOST=<SMTP_HOST>' -e 'SMTP_USER=<SMTP_USER>' -e 'SMTP_PASS=<your smtp_pass>' -- npx -y @aiwerk/mcp-server-imap@1.2.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-server-imap": {
            "command": "npx",
            "args": [
                "-y",
                "@aiwerk/mcp-server-imap@1.2.1"
            ],
            "env": {
                "IMAP_HOST": "<IMAP_HOST>",
                "IMAP_USER": "<IMAP_USER>",
                "IMAP_PASS": "<your imap_pass>",
                "SMTP_HOST": "<SMTP_HOST>",
                "SMTP_USER": "<SMTP_USER>",
                "SMTP_PASS": "<your smtp_pass>"
            }
        }
    }
}

Environment variables

  • 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).

Frequently asked questions

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

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

How do I install io.github.AIWerk/mcp-server-imap?

It runs on your machine. In Claude Code: claude mcp add mcp-server-imap -e 'IMAP_HOST=<IMAP_HOST>' -e 'IMAP_USER=<IMAP_USER>' -e 'IMAP_PASS=<your imap_pass>' -e 'SMTP_HOST=<SMTP_HOST>' -e 'SMTP_USER=<SMTP_USER>' -e 'SMTP_PASS=<your smtp_pass>' -- npx -y @aiwerk/mcp-server-imap@1.2.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.AIWerk/mcp-server-imap need an API key?

Yes. It expects IMAP_HOST, IMAP_USER, IMAP_PASS, SMTP_PASS, which you set in its configuration.

Is io.github.AIWerk/mcp-server-imap open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.AIWerk/mcp-server-imap?

It is published by AIWerk. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.