IMAP mailbox MCP Server

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add imap-mcp -- npx -y @ni-c/imap-mcp

{
  "mcpServers": {
    "imap-mcp": {
      "args": [
        "-y",
        "@ni-c/imap-mcp"
      ],
      "command": "npx"
    }
  }
}

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

{
  "mcpServers": {
    "imap-mcp": {
      "args": [
        "-y",
        "@ni-c/imap-mcp"
      ],
      "command": "npx"
    }
  }
}

{
  "mcpServers": {
    "imap-mcp": {
      "args": [
        "-y",
        "@ni-c/imap-mcp"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: IMAP_HOST (Hostname of the IMAP server, e.g. imap.example.net), IMAP_USER (Mailbox user name), IMAP_PASSWORD (Mailbox password or app password), IMAP_PORT (Defaults to 993 with implicit TLS, 143 otherwise), IMAP_TLS (implicit (default), starttls or none), IMAP_MAILBOX (Default mailbox to work in (default: INBOX)), IMAP_SEEN_KEYWORD (IMAP keyword marking what the assistant has already seen (default: AiSeen)), IMAP_READ_ONLY (Set to false to register the mailbox write tools; defaults to true), IMAP_ALLOW_TOOLS (Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)), IMAP_DENY_TOOLS (Comma-separated tool names or list_* prefixes to remove from whatever IMAP_ALLOW_TOOLS left), IMAP_DOWNLOAD_DIR (Directory attachments may be written to; unset means the server never touches the filesystem), IMAP_INSECURE_TLS (Set to true to accept self-signed certificates, scoped to this connection), IMAP_DRAFTS_MAILBOX (Drafts folder to save into; by default the one flagged \Drafts is used), IMAP_MAX_MESSAGES (Default number of messages a listing returns (default: 100)), IMAP_MAX_ATTACHMENT_BYTES (Ceiling for returning an attachment inline (default: 1048576)), IMAP_MAX_DOWNLOAD_BYTES (Ceiling for writing an attachment to disk (default: 26214400)), IMAP_MAX_EXTRACT_BYTES (Ceiling for reading a document's text with mode=text (default: 10485760, maximum: 67108864)), IMAP_ATTACHMENT_TYPES (Comma-separated content-type allowlist for attachments), IMAP_TRUSTED_AUTHSERV_ID (authserv-id your provider stamps into Authentication-Results; without it every verdict is reported as forgeable). The author declared them in the registry entry; get the values from the project itself.