Package

IMAP mailbox

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

io.github.ni-c/imap-mcpSource repository
Version0.7.0latest catalog version
ConnectionPackagenpm · oci
PublishedNov 04, 2026catalog
UpdatedNov 04, 2026catalog
Overview

What this server provides

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

Install

Packages

2
Package 1npm
@ni-c/imap-mcp0.7.0
  • IMAP_HOST

    Hostname of the IMAP server, e.g. imap.example.net

    Format: string
    Required
  • IMAP_USER

    Mailbox user name

    Format: string
    Required
  • IMAP_PASSWORD

    Mailbox password or app password

    Format: string
    Required
  • IMAP_PORT

    Defaults to 993 with implicit TLS, 143 otherwise

    Format: number
    Optional
  • IMAP_TLS

    implicit (default), starttls or none

    Format: string
    Optional
  • IMAP_MAILBOX

    Default mailbox to work in (default: INBOX)

    Format: string
    Optional
  • IMAP_SEEN_KEYWORD

    IMAP keyword marking what the assistant has already seen (default: AiSeen)

    Format: string
    Optional
  • IMAP_READ_ONLY

    Set to false to register the mailbox write tools; defaults to true

    Format: boolean
    Optional
  • IMAP_ALLOW_TOOLS

    Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)

    Format: string
    Optional
  • IMAP_DENY_TOOLS

    Comma-separated tool names or list_* prefixes to remove from whatever IMAP_ALLOW_TOOLS left

    Format: string
    Optional
  • IMAP_DOWNLOAD_DIR

    Directory attachments may be written to; unset means the server never touches the filesystem

    Format: string
    Optional
  • IMAP_INSECURE_TLS

    Set to true to accept self-signed certificates, scoped to this connection

    Format: boolean
    Optional
  • IMAP_DRAFTS_MAILBOX

    Drafts folder to save into; by default the one flagged \Drafts is used

    Format: string
    Optional
  • IMAP_MAX_MESSAGES

    Default number of messages a listing returns (default: 100)

    Format: number
    Optional
  • IMAP_MAX_ATTACHMENT_BYTES

    Ceiling for returning an attachment inline (default: 1048576)

    Format: number
    Optional
  • IMAP_MAX_DOWNLOAD_BYTES

    Ceiling for writing an attachment to disk (default: 26214400)

    Format: number
    Optional
  • IMAP_MAX_EXTRACT_BYTES

    Ceiling for reading a document's text with mode=text (default: 10485760, maximum: 67108864)

    Format: number
    Optional
  • IMAP_COMMAND_TIMEOUT_SECONDS

    Seconds one IMAP command may take before the call is abandoned (default: 30, maximum: 600)

    Format: number
    Optional
  • IMAP_ATTACHMENT_TYPES

    Comma-separated content-type allowlist for attachments

    Format: string
    Optional
  • IMAP_TRUSTED_AUTHSERV_ID

    authserv-id your provider stamps into Authentication-Results; without it every verdict is reported as forgeable

    Format: string
    Optional
Package 2oci
ghcr.io/ni-c/imap-mcp:0.7.0Version not declared
  • IMAP_HOST

    Hostname of the IMAP server, e.g. imap.example.net

    Format: string
    Required
  • IMAP_USER

    Mailbox user name

    Format: string
    Required
  • IMAP_PASSWORD

    Mailbox password or app password

    Format: string
    Required
  • IMAP_PORT

    Defaults to 993 with implicit TLS, 143 otherwise

    Format: number
    Optional
  • IMAP_TLS

    implicit (default), starttls or none

    Format: string
    Optional
  • IMAP_MAILBOX

    Default mailbox to work in (default: INBOX)

    Format: string
    Optional
  • IMAP_SEEN_KEYWORD

    IMAP keyword marking what the assistant has already seen (default: AiSeen)

    Format: string
    Optional
  • IMAP_READ_ONLY

    Set to false to register the mailbox write tools; defaults to true

    Format: boolean
    Optional
  • IMAP_ALLOW_TOOLS

    Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)

    Format: string
    Optional
  • IMAP_DENY_TOOLS

    Comma-separated tool names or list_* prefixes to remove from whatever IMAP_ALLOW_TOOLS left

    Format: string
    Optional
  • IMAP_DOWNLOAD_DIR

    Directory attachments may be written to; unset means the server never touches the filesystem

    Format: string
    Optional
  • IMAP_INSECURE_TLS

    Set to true to accept self-signed certificates, scoped to this connection

    Format: boolean
    Optional
  • IMAP_DRAFTS_MAILBOX

    Drafts folder to save into; by default the one flagged \Drafts is used

    Format: string
    Optional
  • IMAP_MAX_MESSAGES

    Default number of messages a listing returns (default: 100)

    Format: number
    Optional
  • IMAP_MAX_ATTACHMENT_BYTES

    Ceiling for returning an attachment inline (default: 1048576)

    Format: number
    Optional
  • IMAP_MAX_DOWNLOAD_BYTES

    Ceiling for writing an attachment to disk (default: 26214400)

    Format: number
    Optional
  • IMAP_MAX_EXTRACT_BYTES

    Ceiling for reading a document's text with mode=text (default: 10485760, maximum: 67108864)

    Format: number
    Optional
  • IMAP_COMMAND_TIMEOUT_SECONDS

    Seconds one IMAP command may take before the call is abandoned (default: 30, maximum: 600)

    Format: number
    Optional
  • IMAP_ATTACHMENT_TYPES

    Comma-separated content-type allowlist for attachments

    Format: string
    Optional
  • IMAP_TRUSTED_AUTHSERV_ID

    authserv-id your provider stamps into Authentication-Results; without it every verdict is reported as forgeable

    Format: string
    Optional
View server metadata