{
  "slug": "io-github-ni-c-imap-mcp",
  "name": "io.github.ni-c/imap-mcp",
  "title": "IMAP mailbox",
  "description": "Read, search and organise any IMAP mailbox, with writes off by default",
  "version": "0.5.3",
  "publishedAt": "2026-10-19T13:28:01.468092Z",
  "updatedAt": "2026-10-19T13:28:01.468092Z",
  "repoUrl": "https://github.com/ni-c/imap-mcp",
  "websiteUrl": "https://imap-mcp.ni-c.de",
  "namespace": {
    "type": "github",
    "owner": "ni-c"
  },
  "kind": "local",
  "packages": [
    {
      "registryType": "npm",
      "identifier": "@ni-c/imap-mcp",
      "version": "0.5.3",
      "transport": "stdio",
      "runtimeHint": null
    },
    {
      "registryType": "oci",
      "identifier": "ghcr.io/ni-c/imap-mcp:0.5.3",
      "version": null,
      "transport": "stdio",
      "runtimeHint": null
    }
  ],
  "remotes": [],
  "envVars": [
    {
      "name": "IMAP_HOST",
      "isSecret": false,
      "isRequired": true,
      "description": "Hostname of the IMAP server, e.g. imap.example.net"
    },
    {
      "name": "IMAP_USER",
      "isSecret": false,
      "isRequired": true,
      "description": "Mailbox user name"
    },
    {
      "name": "IMAP_PASSWORD",
      "isSecret": true,
      "isRequired": true,
      "description": "Mailbox password or app password"
    },
    {
      "name": "IMAP_PORT",
      "isSecret": false,
      "isRequired": false,
      "description": "Defaults to 993 with implicit TLS, 143 otherwise"
    },
    {
      "name": "IMAP_TLS",
      "isSecret": false,
      "isRequired": false,
      "description": "implicit (default), starttls or none"
    },
    {
      "name": "IMAP_MAILBOX",
      "isSecret": false,
      "isRequired": false,
      "description": "Default mailbox to work in (default: INBOX)"
    },
    {
      "name": "IMAP_SEEN_KEYWORD",
      "isSecret": false,
      "isRequired": false,
      "description": "IMAP keyword marking what the assistant has already seen (default: AiSeen)"
    },
    {
      "name": "IMAP_READ_ONLY",
      "isSecret": false,
      "isRequired": false,
      "description": "Set to false to register the mailbox write tools; defaults to true"
    },
    {
      "name": "IMAP_ALLOW_TOOLS",
      "isSecret": false,
      "isRequired": false,
      "description": "Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)"
    },
    {
      "name": "IMAP_DENY_TOOLS",
      "isSecret": false,
      "isRequired": false,
      "description": "Comma-separated tool names or list_* prefixes to remove from whatever IMAP_ALLOW_TOOLS left"
    },
    {
      "name": "IMAP_DOWNLOAD_DIR",
      "isSecret": false,
      "isRequired": false,
      "description": "Directory attachments may be written to; unset means the server never touches the filesystem"
    },
    {
      "name": "IMAP_INSECURE_TLS",
      "isSecret": false,
      "isRequired": false,
      "description": "Set to true to accept self-signed certificates, scoped to this connection"
    },
    {
      "name": "IMAP_DRAFTS_MAILBOX",
      "isSecret": false,
      "isRequired": false,
      "description": "Drafts folder to save into; by default the one flagged \\Drafts is used"
    },
    {
      "name": "IMAP_MAX_MESSAGES",
      "isSecret": false,
      "isRequired": false,
      "description": "Default number of messages a listing returns (default: 100)"
    },
    {
      "name": "IMAP_MAX_ATTACHMENT_BYTES",
      "isSecret": false,
      "isRequired": false,
      "description": "Ceiling for returning an attachment inline (default: 1048576)"
    },
    {
      "name": "IMAP_MAX_DOWNLOAD_BYTES",
      "isSecret": false,
      "isRequired": false,
      "description": "Ceiling for writing an attachment to disk (default: 26214400)"
    },
    {
      "name": "IMAP_MAX_EXTRACT_BYTES",
      "isSecret": false,
      "isRequired": false,
      "description": "Ceiling for reading a document's text with mode=text (default: 10485760, maximum: 67108864)"
    },
    {
      "name": "IMAP_ATTACHMENT_TYPES",
      "isSecret": false,
      "isRequired": false,
      "description": "Comma-separated content-type allowlist for attachments"
    },
    {
      "name": "IMAP_TRUSTED_AUTHSERV_ID",
      "isSecret": false,
      "isRequired": false,
      "description": "authserv-id your provider stamps into Authentication-Results; without it every verdict is reported as forgeable"
    }
  ],
  "category": "communication",
  "subcategory": "email",
  "company": "",
  "categoryAuto": true,
  "checks": [
    {
      "id": "source-linked",
      "label": "Source repository linked",
      "result": "pass",
      "detail": "https://github.com/ni-c/imap-mcp"
    },
    {
      "id": "version-pinned",
      "label": "Version pinned",
      "result": "pass",
      "detail": "Every package has an explicit version"
    },
    {
      "id": "secrets-requested",
      "label": "Secrets requested",
      "result": "info",
      "detail": "Asks for 1 secret: IMAP_PASSWORD"
    },
    {
      "id": "known-registry",
      "label": "Known package registry",
      "result": "pass",
      "detail": "All packages come from npm, PyPI, OCI, NuGet or MCPB"
    },
    {
      "id": "namespace",
      "label": "Namespace ownership",
      "result": "info",
      "detail": "Name verified via GitHub account ni-c"
    },
    {
      "id": "meta-text",
      "label": "Registry text aimed at the AI",
      "result": "pass",
      "detail": "Description and settings contain no hidden characters or instructions to the AI"
    },
    {
      "id": "install-scripts",
      "label": "Install scripts",
      "result": "pass",
      "detail": "@ni-c/imap-mcp@0.5.3 runs nothing at install"
    },
    {
      "id": "code-flags",
      "label": "Code red flags",
      "result": "pass",
      "detail": "Read 52 files in @ni-c/imap-mcp@0.5.3: no obfuscation, encoded execution, credential reads or data-collection endpoints found"
    },
    {
      "id": "ai-text",
      "label": "Text aimed at the AI",
      "result": "pass",
      "detail": "No hidden characters or instructions to the AI in 52 files, including comments and the README"
    }
  ],
  "scannedAt": "2026-10-29",
  "level": "Scanned",
  "install": [
    {
      "label": "Claude Desktop (npm)",
      "kind": "claude_desktop_json",
      "text": "{\n  \"mcpServers\": {\n    \"imap-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@ni-c/imap-mcp@0.5.3\"\n      ],\n      \"env\": {\n        \"IMAP_HOST\": \"<your value>\",\n        \"IMAP_USER\": \"<your value>\",\n        \"IMAP_PASSWORD\": \"<your value>\"\n      }\n    }\n  }\n}"
    },
    {
      "label": "Claude Desktop (oci)",
      "kind": "claude_desktop_json",
      "text": "{\n  \"mcpServers\": {\n    \"imap-mcp\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-e\",\n        \"IMAP_HOST\",\n        \"-e\",\n        \"IMAP_USER\",\n        \"-e\",\n        \"IMAP_PASSWORD\",\n        \"ghcr.io/ni-c/imap-mcp:0.5.3\"\n      ],\n      \"env\": {\n        \"IMAP_HOST\": \"<your value>\",\n        \"IMAP_USER\": \"<your value>\",\n        \"IMAP_PASSWORD\": \"<your value>\"\n      }\n    }\n  }\n}"
    }
  ],
  "curated": true,
  "stars": 3,
  "archived": false,
  "pushedAt": "2026-10-26T10:38:19Z",
  "health": {
    "score": 56,
    "parts": {
      "popularity": 0.340174603969053,
      "activity": 0.6,
      "issues": null,
      "security": 1
    },
    "fail": 0,
    "warn": 0,
    "raw": {
      "stars": 4,
      "forks": 7,
      "downloads": 555,
      "hn": null,
      "issuesOpen": 0,
      "issuesClosed": 2,
      "prsMerged": 59,
      "commits90": 0,
      "release": "2026-10-19T13:24:23Z",
      "pushed": "2026-10-26T10:38:19Z",
      "growth": null,
      "growthDays": null,
      "archived": false
    },
    "at": "2026-10-31T07:35:52.424Z"
  }
}