SERVER

IMAP mailbox

Rank #6,293

io.github.ni-c/imap-mcp

Read, search and organise any IMAP mailbox, with writes off by default

6 versions

3 GitHub stars

by ni-c (20 servers)View repository ↗

First listed

Aug 30, 2026

Last publish date

Oct 4, 2026

PURPOSE

What you can do with IMAP mailbox

IMAP mailbox is a Model Context Protocol (MCP) server published by ni-c. It ranks #6,293 of 144,396 active servers on MCP Toplist, and its repository has 3 GitHub stars. IMAP mailbox is listed across 2 registries — Official MCP and Glama, with 6 tracked versions. It was first listed on Aug 30, 2026 and most recently updated on Oct 4, 2026.

Not verifiedMCP Toplist has not yet written a checked profile for this server, so the paragraph above is assembled from registry data only. The repository README is the authority on what it does.

CAPABILITIES AND LIMITATIONS

What IMAP mailbox can and cannot do

Not verifiedMCP Toplist has not catalogued this server's tools or limitations. The repository README lists them.

REQUIREMENTS

What you need before using IMAP mailbox

DeclaredAPI keyCredentials declared

The registry listing declares required configuration before first use — typically an API key, token or connection string set via environment variables.

Declared by Glama, last synced Oct 16, 2026. Not independently verified by MCP Toplist.

Declared in the registry install config

IMAP_HOST · required
IMAP_USER · required
IMAP_PASSWORD · required
IMAP_PORT · optional
IMAP_TLS · optional
IMAP_MAILBOX · optional
IMAP_SEEN_KEYWORD · optional
IMAP_READ_ONLY · optional
IMAP_ALLOW_TOOLS · optional
IMAP_DENY_TOOLS · optional
IMAP_DOWNLOAD_DIR · optional
IMAP_INSECURE_TLS · optional
IMAP_DRAFTS_MAILBOX · optional
IMAP_MAX_MESSAGES · optional
IMAP_MAX_ATTACHMENT_BYTES · optional
IMAP_MAX_DOWNLOAD_BYTES · optional
IMAP_MAX_EXTRACT_BYTES · optional
IMAP_ATTACHMENT_TYPES · optional
IMAP_TRUSTED_AUTHSERV_ID · optional

INSTALLATION AND FIRST TASK

Connect IMAP mailbox and confirm it works

npm package

claude mcp add imap-mcp -e "IMAP_HOST=<your IMAP_HOST>" -e "IMAP_USER=<your IMAP_USER>" -e "IMAP_PASSWORD=<your IMAP_PASSWORD>" -e "IMAP_PORT=<your IMAP_PORT>" -e "IMAP_TLS=<your IMAP_TLS>" -e "IMAP_MAILBOX=<your IMAP_MAILBOX>" -e "IMAP_SEEN_KEYWORD=<your IMAP_SEEN_KEYWORD>" -e "IMAP_READ_ONLY=<your IMAP_READ_ONLY>" -e "IMAP_ALLOW_TOOLS=<your IMAP_ALLOW_TOOLS>" -e "IMAP_DENY_TOOLS=<your IMAP_DENY_TOOLS>" -e "IMAP_DOWNLOAD_DIR=<your IMAP_DOWNLOAD_DIR>" -e "IMAP_INSECURE_TLS=<your IMAP_INSECURE_TLS>" -e "IMAP_DRAFTS_MAILBOX=<your IMAP_DRAFTS_MAILBOX>" -e "IMAP_MAX_MESSAGES=<your IMAP_MAX_MESSAGES>" -e "IMAP_MAX_ATTACHMENT_BYTES=<your IMAP_MAX_ATTACHMENT_BYTES>" -e "IMAP_MAX_DOWNLOAD_BYTES=<your IMAP_MAX_DOWNLOAD_BYTES>" -e "IMAP_MAX_EXTRACT_BYTES=<your IMAP_MAX_EXTRACT_BYTES>" -e "IMAP_ATTACHMENT_TYPES=<your IMAP_ATTACHMENT_TYPES>" -e "IMAP_TRUSTED_AUTHSERV_ID=<your IMAP_TRUSTED_AUTHSERV_ID>" -- npx -y @ni-c/imap-mcp

Replace each placeholder with your own value before saving.

Docker image

claude mcp add imap-mcp -e "IMAP_HOST=<your IMAP_HOST>" -e "IMAP_USER=<your IMAP_USER>" -e "IMAP_PASSWORD=<your IMAP_PASSWORD>" -e "IMAP_PORT=<your IMAP_PORT>" -e "IMAP_TLS=<your IMAP_TLS>" -e "IMAP_MAILBOX=<your IMAP_MAILBOX>" -e "IMAP_SEEN_KEYWORD=<your IMAP_SEEN_KEYWORD>" -e "IMAP_READ_ONLY=<your IMAP_READ_ONLY>" -e "IMAP_ALLOW_TOOLS=<your IMAP_ALLOW_TOOLS>" -e "IMAP_DENY_TOOLS=<your IMAP_DENY_TOOLS>" -e "IMAP_DOWNLOAD_DIR=<your IMAP_DOWNLOAD_DIR>" -e "IMAP_INSECURE_TLS=<your IMAP_INSECURE_TLS>" -e "IMAP_DRAFTS_MAILBOX=<your IMAP_DRAFTS_MAILBOX>" -e "IMAP_MAX_MESSAGES=<your IMAP_MAX_MESSAGES>" -e "IMAP_MAX_ATTACHMENT_BYTES=<your IMAP_MAX_ATTACHMENT_BYTES>" -e "IMAP_MAX_DOWNLOAD_BYTES=<your IMAP_MAX_DOWNLOAD_BYTES>" -e "IMAP_MAX_EXTRACT_BYTES=<your IMAP_MAX_EXTRACT_BYTES>" -e "IMAP_ATTACHMENT_TYPES=<your IMAP_ATTACHMENT_TYPES>" -e "IMAP_TRUSTED_AUTHSERV_ID=<your IMAP_TRUSTED_AUTHSERV_ID>" -- docker run -i --rm ghcr.io/ni-c/imap-mcp:0.5.2

Replace each placeholder with your own value before saving.

npm package

[mcp_servers.imap-mcp]
command = "npx"
args = ["-y", "@ni-c/imap-mcp"]

[mcp_servers.imap-mcp.env]
IMAP_HOST = "<your IMAP_HOST>"
IMAP_USER = "<your IMAP_USER>"
IMAP_PASSWORD = "<your IMAP_PASSWORD>"
IMAP_PORT = "<your IMAP_PORT>"
IMAP_TLS = "<your IMAP_TLS>"
IMAP_MAILBOX = "<your IMAP_MAILBOX>"
IMAP_SEEN_KEYWORD = "<your IMAP_SEEN_KEYWORD>"
IMAP_READ_ONLY = "<your IMAP_READ_ONLY>"
IMAP_ALLOW_TOOLS = "<your IMAP_ALLOW_TOOLS>"
IMAP_DENY_TOOLS = "<your IMAP_DENY_TOOLS>"
IMAP_DOWNLOAD_DIR = "<your IMAP_DOWNLOAD_DIR>"
IMAP_INSECURE_TLS = "<your IMAP_INSECURE_TLS>"
IMAP_DRAFTS_MAILBOX = "<your IMAP_DRAFTS_MAILBOX>"
IMAP_MAX_MESSAGES = "<your IMAP_MAX_MESSAGES>"
IMAP_MAX_ATTACHMENT_BYTES = "<your IMAP_MAX_ATTACHMENT_BYTES>"
IMAP_MAX_DOWNLOAD_BYTES = "<your IMAP_MAX_DOWNLOAD_BYTES>"
IMAP_MAX_EXTRACT_BYTES = "<your IMAP_MAX_EXTRACT_BYTES>"
IMAP_ATTACHMENT_TYPES = "<your IMAP_ATTACHMENT_TYPES>"
IMAP_TRUSTED_AUTHSERV_ID = "<your IMAP_TRUSTED_AUTHSERV_ID>"

Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.

Docker image

[mcp_servers.imap-mcp]
command = "docker"
args = ["run", "-i", "--rm", "ghcr.io/ni-c/imap-mcp:0.5.2"]

[mcp_servers.imap-mcp.env]
IMAP_HOST = "<your IMAP_HOST>"
IMAP_USER = "<your IMAP_USER>"
IMAP_PASSWORD = "<your IMAP_PASSWORD>"
IMAP_PORT = "<your IMAP_PORT>"
IMAP_TLS = "<your IMAP_TLS>"
IMAP_MAILBOX = "<your IMAP_MAILBOX>"
IMAP_SEEN_KEYWORD = "<your IMAP_SEEN_KEYWORD>"
IMAP_READ_ONLY = "<your IMAP_READ_ONLY>"
IMAP_ALLOW_TOOLS = "<your IMAP_ALLOW_TOOLS>"
IMAP_DENY_TOOLS = "<your IMAP_DENY_TOOLS>"
IMAP_DOWNLOAD_DIR = "<your IMAP_DOWNLOAD_DIR>"
IMAP_INSECURE_TLS = "<your IMAP_INSECURE_TLS>"
IMAP_DRAFTS_MAILBOX = "<your IMAP_DRAFTS_MAILBOX>"
IMAP_MAX_MESSAGES = "<your IMAP_MAX_MESSAGES>"
IMAP_MAX_ATTACHMENT_BYTES = "<your IMAP_MAX_ATTACHMENT_BYTES>"
IMAP_MAX_DOWNLOAD_BYTES = "<your IMAP_MAX_DOWNLOAD_BYTES>"
IMAP_MAX_EXTRACT_BYTES = "<your IMAP_MAX_EXTRACT_BYTES>"
IMAP_ATTACHMENT_TYPES = "<your IMAP_ATTACHMENT_TYPES>"
IMAP_TRUSTED_AUTHSERV_ID = "<your IMAP_TRUSTED_AUTHSERV_ID>"

Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.

npm package

{
  "mcpServers": {
    "imap-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/imap-mcp"
      ],
      "env": {
        "IMAP_HOST": "<your IMAP_HOST>",
        "IMAP_USER": "<your IMAP_USER>",
        "IMAP_PASSWORD": "<your IMAP_PASSWORD>",
        "IMAP_PORT": "<your IMAP_PORT>",
        "IMAP_TLS": "<your IMAP_TLS>",
        "IMAP_MAILBOX": "<your IMAP_MAILBOX>",
        "IMAP_SEEN_KEYWORD": "<your IMAP_SEEN_KEYWORD>",
        "IMAP_READ_ONLY": "<your IMAP_READ_ONLY>",
        "IMAP_ALLOW_TOOLS": "<your IMAP_ALLOW_TOOLS>",
        "IMAP_DENY_TOOLS": "<your IMAP_DENY_TOOLS>",
        "IMAP_DOWNLOAD_DIR": "<your IMAP_DOWNLOAD_DIR>",
        "IMAP_INSECURE_TLS": "<your IMAP_INSECURE_TLS>",
        "IMAP_DRAFTS_MAILBOX": "<your IMAP_DRAFTS_MAILBOX>",
        "IMAP_MAX_MESSAGES": "<your IMAP_MAX_MESSAGES>",
        "IMAP_MAX_ATTACHMENT_BYTES": "<your IMAP_MAX_ATTACHMENT_BYTES>",
        "IMAP_MAX_DOWNLOAD_BYTES": "<your IMAP_MAX_DOWNLOAD_BYTES>",
        "IMAP_MAX_EXTRACT_BYTES": "<your IMAP_MAX_EXTRACT_BYTES>",
        "IMAP_ATTACHMENT_TYPES": "<your IMAP_ATTACHMENT_TYPES>",
        "IMAP_TRUSTED_AUTHSERV_ID": "<your IMAP_TRUSTED_AUTHSERV_ID>"
      }
    }
  }
}

Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.

Docker image

{
  "mcpServers": {
    "imap-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ni-c/imap-mcp:0.5.2"
      ],
      "env": {
        "IMAP_HOST": "<your IMAP_HOST>",
        "IMAP_USER": "<your IMAP_USER>",
        "IMAP_PASSWORD": "<your IMAP_PASSWORD>",
        "IMAP_PORT": "<your IMAP_PORT>",
        "IMAP_TLS": "<your IMAP_TLS>",
        "IMAP_MAILBOX": "<your IMAP_MAILBOX>",
        "IMAP_SEEN_KEYWORD": "<your IMAP_SEEN_KEYWORD>",
        "IMAP_READ_ONLY": "<your IMAP_READ_ONLY>",
        "IMAP_ALLOW_TOOLS": "<your IMAP_ALLOW_TOOLS>",
        "IMAP_DENY_TOOLS": "<your IMAP_DENY_TOOLS>",
        "IMAP_DOWNLOAD_DIR": "<your IMAP_DOWNLOAD_DIR>",
        "IMAP_INSECURE_TLS": "<your IMAP_INSECURE_TLS>",
        "IMAP_DRAFTS_MAILBOX": "<your IMAP_DRAFTS_MAILBOX>",
        "IMAP_MAX_MESSAGES": "<your IMAP_MAX_MESSAGES>",
        "IMAP_MAX_ATTACHMENT_BYTES": "<your IMAP_MAX_ATTACHMENT_BYTES>",
        "IMAP_MAX_DOWNLOAD_BYTES": "<your IMAP_MAX_DOWNLOAD_BYTES>",
        "IMAP_MAX_EXTRACT_BYTES": "<your IMAP_MAX_EXTRACT_BYTES>",
        "IMAP_ATTACHMENT_TYPES": "<your IMAP_ATTACHMENT_TYPES>",
        "IMAP_TRUSTED_AUTHSERV_ID": "<your IMAP_TRUSTED_AUTHSERV_ID>"
      }
    }
  }
}

Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.

npm package

{
  "mcpServers": {
    "imap-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/imap-mcp"
      ],
      "env": {
        "IMAP_HOST": "<your IMAP_HOST>",
        "IMAP_USER": "<your IMAP_USER>",
        "IMAP_PASSWORD": "<your IMAP_PASSWORD>",
        "IMAP_PORT": "<your IMAP_PORT>",
        "IMAP_TLS": "<your IMAP_TLS>",
        "IMAP_MAILBOX": "<your IMAP_MAILBOX>",
        "IMAP_SEEN_KEYWORD": "<your IMAP_SEEN_KEYWORD>",
        "IMAP_READ_ONLY": "<your IMAP_READ_ONLY>",
        "IMAP_ALLOW_TOOLS": "<your IMAP_ALLOW_TOOLS>",
        "IMAP_DENY_TOOLS": "<your IMAP_DENY_TOOLS>",
        "IMAP_DOWNLOAD_DIR": "<your IMAP_DOWNLOAD_DIR>",
        "IMAP_INSECURE_TLS": "<your IMAP_INSECURE_TLS>",
        "IMAP_DRAFTS_MAILBOX": "<your IMAP_DRAFTS_MAILBOX>",
        "IMAP_MAX_MESSAGES": "<your IMAP_MAX_MESSAGES>",
        "IMAP_MAX_ATTACHMENT_BYTES": "<your IMAP_MAX_ATTACHMENT_BYTES>",
        "IMAP_MAX_DOWNLOAD_BYTES": "<your IMAP_MAX_DOWNLOAD_BYTES>",
        "IMAP_MAX_EXTRACT_BYTES": "<your IMAP_MAX_EXTRACT_BYTES>",
        "IMAP_ATTACHMENT_TYPES": "<your IMAP_ATTACHMENT_TYPES>",
        "IMAP_TRUSTED_AUTHSERV_ID": "<your IMAP_TRUSTED_AUTHSERV_ID>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.

Docker image

{
  "mcpServers": {
    "imap-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ni-c/imap-mcp:0.5.2"
      ],
      "env": {
        "IMAP_HOST": "<your IMAP_HOST>",
        "IMAP_USER": "<your IMAP_USER>",
        "IMAP_PASSWORD": "<your IMAP_PASSWORD>",
        "IMAP_PORT": "<your IMAP_PORT>",
        "IMAP_TLS": "<your IMAP_TLS>",
        "IMAP_MAILBOX": "<your IMAP_MAILBOX>",
        "IMAP_SEEN_KEYWORD": "<your IMAP_SEEN_KEYWORD>",
        "IMAP_READ_ONLY": "<your IMAP_READ_ONLY>",
        "IMAP_ALLOW_TOOLS": "<your IMAP_ALLOW_TOOLS>",
        "IMAP_DENY_TOOLS": "<your IMAP_DENY_TOOLS>",
        "IMAP_DOWNLOAD_DIR": "<your IMAP_DOWNLOAD_DIR>",
        "IMAP_INSECURE_TLS": "<your IMAP_INSECURE_TLS>",
        "IMAP_DRAFTS_MAILBOX": "<your IMAP_DRAFTS_MAILBOX>",
        "IMAP_MAX_MESSAGES": "<your IMAP_MAX_MESSAGES>",
        "IMAP_MAX_ATTACHMENT_BYTES": "<your IMAP_MAX_ATTACHMENT_BYTES>",
        "IMAP_MAX_DOWNLOAD_BYTES": "<your IMAP_MAX_DOWNLOAD_BYTES>",
        "IMAP_MAX_EXTRACT_BYTES": "<your IMAP_MAX_EXTRACT_BYTES>",
        "IMAP_ATTACHMENT_TYPES": "<your IMAP_ATTACHMENT_TYPES>",
        "IMAP_TRUSTED_AUTHSERV_ID": "<your IMAP_TRUSTED_AUTHSERV_ID>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.

npm package

{
  "servers": {
    "imap-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/imap-mcp"
      ],
      "env": {
        "IMAP_HOST": "<your IMAP_HOST>",
        "IMAP_USER": "<your IMAP_USER>",
        "IMAP_PASSWORD": "<your IMAP_PASSWORD>",
        "IMAP_PORT": "<your IMAP_PORT>",
        "IMAP_TLS": "<your IMAP_TLS>",
        "IMAP_MAILBOX": "<your IMAP_MAILBOX>",
        "IMAP_SEEN_KEYWORD": "<your IMAP_SEEN_KEYWORD>",
        "IMAP_READ_ONLY": "<your IMAP_READ_ONLY>",
        "IMAP_ALLOW_TOOLS": "<your IMAP_ALLOW_TOOLS>",
        "IMAP_DENY_TOOLS": "<your IMAP_DENY_TOOLS>",
        "IMAP_DOWNLOAD_DIR": "<your IMAP_DOWNLOAD_DIR>",
        "IMAP_INSECURE_TLS": "<your IMAP_INSECURE_TLS>",
        "IMAP_DRAFTS_MAILBOX": "<your IMAP_DRAFTS_MAILBOX>",
        "IMAP_MAX_MESSAGES": "<your IMAP_MAX_MESSAGES>",
        "IMAP_MAX_ATTACHMENT_BYTES": "<your IMAP_MAX_ATTACHMENT_BYTES>",
        "IMAP_MAX_DOWNLOAD_BYTES": "<your IMAP_MAX_DOWNLOAD_BYTES>",
        "IMAP_MAX_EXTRACT_BYTES": "<your IMAP_MAX_EXTRACT_BYTES>",
        "IMAP_ATTACHMENT_TYPES": "<your IMAP_ATTACHMENT_TYPES>",
        "IMAP_TRUSTED_AUTHSERV_ID": "<your IMAP_TRUSTED_AUTHSERV_ID>"
      }
    }
  }
}

Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.

Docker image

{
  "servers": {
    "imap-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ni-c/imap-mcp:0.5.2"
      ],
      "env": {
        "IMAP_HOST": "<your IMAP_HOST>",
        "IMAP_USER": "<your IMAP_USER>",
        "IMAP_PASSWORD": "<your IMAP_PASSWORD>",
        "IMAP_PORT": "<your IMAP_PORT>",
        "IMAP_TLS": "<your IMAP_TLS>",
        "IMAP_MAILBOX": "<your IMAP_MAILBOX>",
        "IMAP_SEEN_KEYWORD": "<your IMAP_SEEN_KEYWORD>",
        "IMAP_READ_ONLY": "<your IMAP_READ_ONLY>",
        "IMAP_ALLOW_TOOLS": "<your IMAP_ALLOW_TOOLS>",
        "IMAP_DENY_TOOLS": "<your IMAP_DENY_TOOLS>",
        "IMAP_DOWNLOAD_DIR": "<your IMAP_DOWNLOAD_DIR>",
        "IMAP_INSECURE_TLS": "<your IMAP_INSECURE_TLS>",
        "IMAP_DRAFTS_MAILBOX": "<your IMAP_DRAFTS_MAILBOX>",
        "IMAP_MAX_MESSAGES": "<your IMAP_MAX_MESSAGES>",
        "IMAP_MAX_ATTACHMENT_BYTES": "<your IMAP_MAX_ATTACHMENT_BYTES>",
        "IMAP_MAX_DOWNLOAD_BYTES": "<your IMAP_MAX_DOWNLOAD_BYTES>",
        "IMAP_MAX_EXTRACT_BYTES": "<your IMAP_MAX_EXTRACT_BYTES>",
        "IMAP_ATTACHMENT_TYPES": "<your IMAP_ATTACHMENT_TYPES>",
        "IMAP_TRUSTED_AUTHSERV_ID": "<your IMAP_TRUSTED_AUTHSERV_ID>"
      }
    }
  }
}

Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.

npm package

{
  "mcpServers": {
    "imap-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/imap-mcp"
      ],
      "env": {
        "IMAP_HOST": "<your IMAP_HOST>",
        "IMAP_USER": "<your IMAP_USER>",
        "IMAP_PASSWORD": "<your IMAP_PASSWORD>",
        "IMAP_PORT": "<your IMAP_PORT>",
        "IMAP_TLS": "<your IMAP_TLS>",
        "IMAP_MAILBOX": "<your IMAP_MAILBOX>",
        "IMAP_SEEN_KEYWORD": "<your IMAP_SEEN_KEYWORD>",
        "IMAP_READ_ONLY": "<your IMAP_READ_ONLY>",
        "IMAP_ALLOW_TOOLS": "<your IMAP_ALLOW_TOOLS>",
        "IMAP_DENY_TOOLS": "<your IMAP_DENY_TOOLS>",
        "IMAP_DOWNLOAD_DIR": "<your IMAP_DOWNLOAD_DIR>",
        "IMAP_INSECURE_TLS": "<your IMAP_INSECURE_TLS>",
        "IMAP_DRAFTS_MAILBOX": "<your IMAP_DRAFTS_MAILBOX>",
        "IMAP_MAX_MESSAGES": "<your IMAP_MAX_MESSAGES>",
        "IMAP_MAX_ATTACHMENT_BYTES": "<your IMAP_MAX_ATTACHMENT_BYTES>",
        "IMAP_MAX_DOWNLOAD_BYTES": "<your IMAP_MAX_DOWNLOAD_BYTES>",
        "IMAP_MAX_EXTRACT_BYTES": "<your IMAP_MAX_EXTRACT_BYTES>",
        "IMAP_ATTACHMENT_TYPES": "<your IMAP_ATTACHMENT_TYPES>",
        "IMAP_TRUSTED_AUTHSERV_ID": "<your IMAP_TRUSTED_AUTHSERV_ID>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.

Docker image

{
  "mcpServers": {
    "imap-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ni-c/imap-mcp:0.5.2"
      ],
      "env": {
        "IMAP_HOST": "<your IMAP_HOST>",
        "IMAP_USER": "<your IMAP_USER>",
        "IMAP_PASSWORD": "<your IMAP_PASSWORD>",
        "IMAP_PORT": "<your IMAP_PORT>",
        "IMAP_TLS": "<your IMAP_TLS>",
        "IMAP_MAILBOX": "<your IMAP_MAILBOX>",
        "IMAP_SEEN_KEYWORD": "<your IMAP_SEEN_KEYWORD>",
        "IMAP_READ_ONLY": "<your IMAP_READ_ONLY>",
        "IMAP_ALLOW_TOOLS": "<your IMAP_ALLOW_TOOLS>",
        "IMAP_DENY_TOOLS": "<your IMAP_DENY_TOOLS>",
        "IMAP_DOWNLOAD_DIR": "<your IMAP_DOWNLOAD_DIR>",
        "IMAP_INSECURE_TLS": "<your IMAP_INSECURE_TLS>",
        "IMAP_DRAFTS_MAILBOX": "<your IMAP_DRAFTS_MAILBOX>",
        "IMAP_MAX_MESSAGES": "<your IMAP_MAX_MESSAGES>",
        "IMAP_MAX_ATTACHMENT_BYTES": "<your IMAP_MAX_ATTACHMENT_BYTES>",
        "IMAP_MAX_DOWNLOAD_BYTES": "<your IMAP_MAX_DOWNLOAD_BYTES>",
        "IMAP_MAX_EXTRACT_BYTES": "<your IMAP_MAX_EXTRACT_BYTES>",
        "IMAP_ATTACHMENT_TYPES": "<your IMAP_ATTACHMENT_TYPES>",
        "IMAP_TRUSTED_AUTHSERV_ID": "<your IMAP_TRUSTED_AUTHSERV_ID>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.

npm package

{
  "mcpServers": {
    "imap-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/imap-mcp"
      ],
      "env": {
        "IMAP_HOST": "<your IMAP_HOST>",
        "IMAP_USER": "<your IMAP_USER>",
        "IMAP_PASSWORD": "<your IMAP_PASSWORD>",
        "IMAP_PORT": "<your IMAP_PORT>",
        "IMAP_TLS": "<your IMAP_TLS>",
        "IMAP_MAILBOX": "<your IMAP_MAILBOX>",
        "IMAP_SEEN_KEYWORD": "<your IMAP_SEEN_KEYWORD>",
        "IMAP_READ_ONLY": "<your IMAP_READ_ONLY>",
        "IMAP_ALLOW_TOOLS": "<your IMAP_ALLOW_TOOLS>",
        "IMAP_DENY_TOOLS": "<your IMAP_DENY_TOOLS>",
        "IMAP_DOWNLOAD_DIR": "<your IMAP_DOWNLOAD_DIR>",
        "IMAP_INSECURE_TLS": "<your IMAP_INSECURE_TLS>",
        "IMAP_DRAFTS_MAILBOX": "<your IMAP_DRAFTS_MAILBOX>",
        "IMAP_MAX_MESSAGES": "<your IMAP_MAX_MESSAGES>",
        "IMAP_MAX_ATTACHMENT_BYTES": "<your IMAP_MAX_ATTACHMENT_BYTES>",
        "IMAP_MAX_DOWNLOAD_BYTES": "<your IMAP_MAX_DOWNLOAD_BYTES>",
        "IMAP_MAX_EXTRACT_BYTES": "<your IMAP_MAX_EXTRACT_BYTES>",
        "IMAP_ATTACHMENT_TYPES": "<your IMAP_ATTACHMENT_TYPES>",
        "IMAP_TRUSTED_AUTHSERV_ID": "<your IMAP_TRUSTED_AUTHSERV_ID>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

Docker image

{
  "mcpServers": {
    "imap-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ni-c/imap-mcp:0.5.2"
      ],
      "env": {
        "IMAP_HOST": "<your IMAP_HOST>",
        "IMAP_USER": "<your IMAP_USER>",
        "IMAP_PASSWORD": "<your IMAP_PASSWORD>",
        "IMAP_PORT": "<your IMAP_PORT>",
        "IMAP_TLS": "<your IMAP_TLS>",
        "IMAP_MAILBOX": "<your IMAP_MAILBOX>",
        "IMAP_SEEN_KEYWORD": "<your IMAP_SEEN_KEYWORD>",
        "IMAP_READ_ONLY": "<your IMAP_READ_ONLY>",
        "IMAP_ALLOW_TOOLS": "<your IMAP_ALLOW_TOOLS>",
        "IMAP_DENY_TOOLS": "<your IMAP_DENY_TOOLS>",
        "IMAP_DOWNLOAD_DIR": "<your IMAP_DOWNLOAD_DIR>",
        "IMAP_INSECURE_TLS": "<your IMAP_INSECURE_TLS>",
        "IMAP_DRAFTS_MAILBOX": "<your IMAP_DRAFTS_MAILBOX>",
        "IMAP_MAX_MESSAGES": "<your IMAP_MAX_MESSAGES>",
        "IMAP_MAX_ATTACHMENT_BYTES": "<your IMAP_MAX_ATTACHMENT_BYTES>",
        "IMAP_MAX_DOWNLOAD_BYTES": "<your IMAP_MAX_DOWNLOAD_BYTES>",
        "IMAP_MAX_EXTRACT_BYTES": "<your IMAP_MAX_EXTRACT_BYTES>",
        "IMAP_ATTACHMENT_TYPES": "<your IMAP_ATTACHMENT_TYPES>",
        "IMAP_TRUSTED_AUTHSERV_ID": "<your IMAP_TRUSTED_AUTHSERV_ID>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

First successful task

After adding the config, ask your client to list this server's tools. A tool list confirms the connection; an empty list or an error means the server did not start or needs credentials.

ALTERNATIVES

When to choose another server

Other servers by ni-c

View all ni-c servers →

No task-specific alternatives are catalogued for IMAP mailboxyet; the list above is its publisher's other servers.

MAINTENANCE AND EVIDENCE

What changed, and when this was checked

First listed: Aug 30, 2026
Latest version published: Oct 4, 2026
Version history: 6 versions tracked (below)
Requirements evidence: Declared by Glama, last synced Oct 16, 2026. Not independently verified by MCP Toplist.
Profile checked: Not yet — purpose, capabilities and requirements above come from registry data only
Ranking data as of: Oct 16, 2026

Registry sightings

Official MCP ↗listed since Aug 31, 2026 · still listed
Glama ↗listed since Sep 4, 2026 · still listed

Do you maintain IMAP mailbox? to correct or enrich this profile.

VERSIONS

Available versions (6)

Version	Published
0.5.2	Oct 4, 2026
0.5.1	Sep 29, 2026
0.5.0	Sep 7, 2026
0.4.0	Sep 4, 2026
0.3.0	Sep 3, 2026
0.2.0	Aug 30, 2026

STANDING

#6,293of 144,396 active serversTop 5%

Ranks ahead of 138,103 of 144,396 servers on MCP Toplist.

BADGE

Show your rank

Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.

Markdown

[![MCP Toplist](https://mcptoplist.com/badge/io.github.ni-c%2Fimap-mcp.svg)](https://mcptoplist.com/server/io.github.ni-c%2Fimap-mcp)

HTML

<a href="https://mcptoplist.com/server/io.github.ni-c%2Fimap-mcp"><img src="https://mcptoplist.com/badge/io.github.ni-c%2Fimap-mcp.svg" alt="MCP Toplist: Top 5% of 144,396" /></a>

Variants: append ?metric=score or ?metric=stars to the image URL.

FAQ

Frequently asked questions

Who maintains IMAP mailbox?: IMAP mailbox is maintained by ni-c, which publishes 20 MCP servers (129 total versions) tracked on MCP Toplist.
Is IMAP mailbox listed on the Official MCP Registry?: Yes — IMAP mailbox is listed on the Official MCP Registry, alongside Glama.
How many versions does IMAP mailbox have?: MCP Toplist tracks 6 versions of IMAP mailbox, most recently published on Oct 4, 2026.
Where can I find the source code for IMAP mailbox?: The source code for IMAP mailbox is hosted at github.com/ni-c/imap-mcp.

Used in projects

Do you run this server?

Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.

EXPLORE

All MCP Servers Official MCP Servers GitHub MCP Servers Best MCP Servers Most Active MCP Servers New MCP Servers Best New MCP Servers