IMAP mailbox MCP Setup & Guide

{
  "id": "io.github.ni-c/imap-mcp",
  "type": "mcp-server",
  "version": "0.5.2",
  "displayName": "IMAP mailbox",
  "description": "Read, search and organise any IMAP mailbox, with writes off by default",
  "repository": {
    "url": "https://github.com/ni-c/imap-mcp",
    "source": "github"
  },
  "homepage": "https://imap-mcp.ni-c.de",
  "distribution": {
    "packages": [
      {
        "registryType": "npm",
        "identifier": "@ni-c/imap-mcp",
        "version": "0.5.2",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "IMAP_HOST",
            "description": "Hostname of the IMAP server, e.g. imap.example.net",
            "isRequired": true
          },
          {
            "name": "IMAP_USER",
            "description": "Mailbox user name",
            "isRequired": true
          },
          {
            "name": "IMAP_PASSWORD",
            "description": "Mailbox password or app password",
            "isRequired": true,
            "isSecret": true
          },
          {
            "name": "IMAP_PORT",
            "description": "Defaults to 993 with implicit TLS, 143 otherwise"
          },
          {
            "name": "IMAP_TLS",
            "description": "implicit (default), starttls or none"
          },
          {
            "name": "IMAP_MAILBOX",
            "description": "Default mailbox to work in (default: INBOX)"
          },
          {
            "name": "IMAP_SEEN_KEYWORD",
            "description": "IMAP keyword marking what the assistant has already seen (default: AiSeen)"
          },
          {
            "name": "IMAP_READ_ONLY",
            "description": "Set to false to register the mailbox write tools; defaults to true"
          },
          {
            "name": "IMAP_ALLOW_TOOLS",
            "description": "Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)"
          },
          {
            "name": "IMAP_DENY_TOOLS",
            "description": "Comma-separated tool names or list_* prefixes to remove from whatever IMAP_ALLOW_TOOLS left"
          },
          {
            "name": "IMAP_DOWNLOAD_DIR",
            "description": "Directory attachments may be written to; unset means the server never touches the filesystem"
          },
          {
            "name": "IMAP_INSECURE_TLS",
            "description": "Set to true to accept self-signed certificates, scoped to this connection"
          },
          {
            "name": "IMAP_DRAFTS_MAILBOX",
            "description": "Drafts folder to save into; by default the one flagged \\Drafts is used"
          },
          {
            "name": "IMAP_MAX_MESSAGES",
            "description": "Default number of messages a listing returns (default: 100)"
          },
          {
            "name": "IMAP_MAX_ATTACHMENT_BYTES",
            "description": "Ceiling for returning an attachment inline (default: 1048576)"
          },
          {
            "name": "IMAP_MAX_DOWNLOAD_BYTES",
            "description": "Ceiling for writing an attachment to disk (default: 26214400)"
          },
          {
            "name": "IMAP_MAX_EXTRACT_BYTES",
            "description": "Ceiling for reading a document's text with mode=text (default: 10485760, maximum: 67108864)"
          },
          {
            "name": "IMAP_ATTACHMENT_TYPES",
            "description": "Comma-separated content-type allowlist for attachments"
          },
          {
            "name": "IMAP_TRUSTED_AUTHSERV_ID",
            "description": "authserv-id your provider stamps into Authentication-Results; without it every verdict is reported as forgeable"
          }
        ]
      },
      {
        "registryType": "oci",
        "identifier": "ghcr.io/ni-c/imap-mcp:0.5.2",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "IMAP_HOST",
            "description": "Hostname of the IMAP server, e.g. imap.example.net",
            "isRequired": true
          },
          {
            "name": "IMAP_USER",
            "description": "Mailbox user name",
            "isRequired": true
          },
          {
            "name": "IMAP_PASSWORD",
            "description": "Mailbox password or app password",
            "isRequired": true,
            "isSecret": true
          },
          {
            "name": "IMAP_PORT",
            "description": "Defaults to 993 with implicit TLS, 143 otherwise"
          },
          {
            "name": "IMAP_TLS",
            "description": "implicit (default), starttls or none"
          },
          {
            "name": "IMAP_MAILBOX",
            "description": "Default mailbox to work in (default: INBOX)"
          },
          {
            "name": "IMAP_SEEN_KEYWORD",
            "description": "IMAP keyword marking what the assistant has already seen (default: AiSeen)"
          },
          {
            "name": "IMAP_READ_ONLY",
            "description": "Set to false to register the mailbox write tools; defaults to true"
          },
          {
            "name": "IMAP_ALLOW_TOOLS",
            "description": "Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)"
          },
          {
            "name": "IMAP_DENY_TOOLS",
            "description": "Comma-separated tool names or list_* prefixes to remove from whatever IMAP_ALLOW_TOOLS left"
          },
          {
            "name": "IMAP_DOWNLOAD_DIR",
            "description": "Directory attachments may be written to; unset means the server never touches the filesystem"
          },
          {
            "name": "IMAP_INSECURE_TLS",
            "description": "Set to true to accept self-signed certificates, scoped to this connection"
          },
          {
            "name": "IMAP_DRAFTS_MAILBOX",
            "description": "Drafts folder to save into; by default the one flagged \\Drafts is used"
          },
          {
            "name": "IMAP_MAX_MESSAGES",
            "description": "Default number of messages a listing returns (default: 100)"
          },
          {
            "name": "IMAP_MAX_ATTACHMENT_BYTES",
            "description": "Ceiling for returning an attachment inline (default: 1048576)"
          },
          {
            "name": "IMAP_MAX_DOWNLOAD_BYTES",
            "description": "Ceiling for writing an attachment to disk (default: 26214400)"
          },
          {
            "name": "IMAP_MAX_EXTRACT_BYTES",
            "description": "Ceiling for reading a document's text with mode=text (default: 10485760, maximum: 67108864)"
          },
          {
            "name": "IMAP_ATTACHMENT_TYPES",
            "description": "Comma-separated content-type allowlist for attachments"
          },
          {
            "name": "IMAP_TRUSTED_AUTHSERV_ID",
            "description": "authserv-id your provider stamps into Authentication-Results; without it every verdict is reported as forgeable"
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode",
    "trae",
    "cherry-studio",
    "lingma",
    "windsurf",
    "cline",
    "workbuddy"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.ni-c/imap-mcp",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.ni-c%2Fimap-mcp/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}