IMAP mailbox MCP Server

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

Local serverstdio

What is the IMAP mailbox MCP Server?

IMAP mailbox is an MCP integration. Read, search and organise any IMAP mailbox, with writes off by default.

Packages and local setup

The published npm package is @ni-c/imap-mcp, version 0.5.2. Its declared MCP transport is stdio.

The package declares IMAP_HOST (required): Hostname of the IMAP server, e.g. imap.example.net; IMAP_USER (required): Mailbox user name; IMAP_PASSWORD (required): 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 published oci package is ghcr.io/ni-c/imap-mcp:0.5.2. Its declared MCP transport is stdio.

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository · Project website. This profile uses version 0.5.2 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related communication MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
IMAP_HOSTHostname of the IMAP server, e.g. imap.example.netYes
IMAP_USERMailbox user nameYes
IMAP_PASSWORDMailbox password or app passwordYes
IMAP_PORTDefaults to 993 with implicit TLS, 143 otherwiseOptional
IMAP_TLSimplicit (default), starttls or noneOptional
IMAP_MAILBOXDefault mailbox to work in (default: INBOX)Optional
IMAP_SEEN_KEYWORDIMAP keyword marking what the assistant has already seen (default: AiSeen)Optional
IMAP_READ_ONLYSet to false to register the mailbox write tools; defaults to trueOptional
IMAP_ALLOW_TOOLSComma-separated tool names or list_ prefixes to register; 'essential' selects a curated preset (default: all tools)Optional
IMAP_DENY_TOOLSComma-separated tool names or list_ prefixes to remove from whatever IMAP_ALLOW_TOOLS leftOptional
IMAP_DOWNLOAD_DIRDirectory attachments may be written to; unset means the server never touches the filesystemOptional
IMAP_INSECURE_TLSSet to true to accept self-signed certificates, scoped to this connectionOptional
IMAP_DRAFTS_MAILBOXDrafts folder to save into; by default the one flagged \Drafts is usedOptional
IMAP_MAX_MESSAGESDefault number of messages a listing returns (default: 100)Optional
IMAP_MAX_ATTACHMENT_BYTESCeiling for returning an attachment inline (default: 1048576)Optional
IMAP_MAX_DOWNLOAD_BYTESCeiling for writing an attachment to disk (default: 26214400)Optional
IMAP_MAX_EXTRACT_BYTESCeiling for reading a document's text with mode=text (default: 10485760, maximum: 67108864)Optional
IMAP_ATTACHMENT_TYPESComma-separated content-type allowlist for attachmentsOptional
IMAP_TRUSTED_AUTHSERV_IDauthserv-id your provider stamps into Authentication-Results; without it every verdict is reported as forgeableOptional