Official MCP Registry · published 2h ago

IMAP Mail

io.github.buzzer/imap-mcp

Read and search IMAP mailboxes and create drafts. Sending and deleting are not possible.

Version: 0.2.1
Runs: Locally
Packages: oci
Published: Nov 13, 2026

Get started

Add it to your agent

claude mcp add imap-mail -e IMAP_HOST=… -e MAIL_USER=… -e MAIL_PASSWORD=… -- docker run -i --rm ghcr.io/buzzer/imap-mcp:0.2.1

Run in your terminal. Add --scope project to share it with your team through .mcp.json.

codex mcp add imap-mail --env IMAP_HOST=… --env MAIL_USER=… --env MAIL_PASSWORD=… -- docker run -i --rm ghcr.io/buzzer/imap-mcp:0.2.1

Saved to ~/.codex/config.toml.

{
  "mcpServers": {
    "imap-mail": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/buzzer/imap-mcp:0.2.1"
      ],
      "env": {
        "IMAP_HOST": "…",
        "MAIL_USER": "…",
        "MAIL_PASSWORD": "…"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project).

{
  "servers": {
    "imap-mail": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/buzzer/imap-mcp:0.2.1"
      ],
      "env": {
        "IMAP_HOST": "…",
        "MAIL_USER": "…",
        "MAIL_PASSWORD": "…"
      }
    }
  }
}

Add to .vscode/mcp.json, then start it from the MCP view in Copilot Chat.

gemini mcp add imap-mail docker run -i --rm ghcr.io/buzzer/imap-mcp:0.2.1

Saved to .gemini/settings.json.

Before you start

Environment variables

IMAP_HOSTrequiredIMAP server host name (IMAPS), e.g. imap.example.com
MAIL_USERrequiredIMAP login, usually the mail address
MAIL_PASSWORDrequiredsecretIMAP password; an app-specific password where the provider requires one
IMAP_PORTIMAPS port
MAIL_ADDRESSOwn sender address, if it differs from the login
MAIL_FROM_NAMEDisplay name used as sender of drafts
MAIL_ALIASESAdditional allowed sender addresses, comma-separated; *@example.com allows a whole domain
DRAFTS_FOLDERDrafts folder, if it is not detected automatically
MARK_READ_ON_READread_message marks every message it returns as read
DRAFT_UNREADStore new drafts as unread, so they stand out in the mailbox