IMAP Mail

Local install

io.github.buzzer/imap-mcpv0.2.0 GitHub verified

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

Communication

Watch Source

Registry entry

Open in the registry

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-10T13:23:53.995065Z",
      "publishedAt": "2026-11-10T13:23:53.995065Z",
      "statusChangedAt": "2026-11-10T13:23:53.995065Z"
    }
  },
  "server": {
    "name": "io.github.buzzer/imap-mcp",
    "title": "IMAP Mail",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "version": "0.2.0",
    "packages": [
      {
        "transport": {
          "type": "stdio"
        },
        "identifier": "ghcr.io/buzzer/imap-mcp:0.2.0",
        "registryType": "oci",
        "environmentVariables": [
          {
            "name": "IMAP_HOST",
            "format": "string",
            "isRequired": true,
            "description": "IMAP server host name (IMAPS), e.g. imap.example.com"
          },
          {
            "name": "MAIL_USER",
            "format": "string",
            "isRequired": true,
            "description": "IMAP login, usually the mail address"
          },
          {
            "name": "MAIL_PASSWORD",
            "format": "string",
            "isSecret": true,
            "isRequired": true,
            "description": "IMAP password; an app-specific password where the provider requires one"
          },
          {
            "name": "IMAP_PORT",
            "format": "number",
            "default": "993",
            "description": "IMAPS port"
          },
          {
            "name": "MAIL_ADDRESS",
            "format": "string",
            "description": "Own sender address, if it differs from the login"
          },
          {
            "name": "MAIL_FROM_NAME",
            "format": "string",
            "description": "Display name used as sender of drafts"
          },
          {
            "name": "MAIL_ALIASES",
            "format": "string",
            "description": "Additional allowed sender addresses, comma-separated; *@example.com allows a whole domain"
          },
          {
            "name": "DRAFTS_FOLDER",
            "format": "string",
            "description": "Drafts folder, if it is not detected automatically"
          },
          {
            "name": "MARK_READ_ON_READ",
            "format": "boolean",
            "default": "false",
            "description": "read_message marks every message it returns as read"
          },
          {
            "name": "BCC_SELF",
            "format": "boolean",
            "default": "false",
            "description": "Add the sender address as Bcc to every draft"
          }
        ]
      }
    ],
    "repository": {
      "url": "https://github.com/buzzer/imap-mcp",
      "source": "github"
    },
    "description": "Read and search IMAP mailboxes and create drafts. Sending and deleting are not possible."
  }
}

Maintain this server? Claim it

Try it

This server only runs locally, from a package. Install it with the instructions on this page to try it.

Install

Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.

One click: Add to Cursor Add to VS Code Add to LM StudioThen replace the YOUR_ values and {placeholders} with your own.

Run in a terminal

claude mcp add imap-mcp \
  -e IMAP_HOST=YOUR_IMAP_HOST \
  -e MAIL_USER=YOUR_MAIL_USER \
  -e MAIL_PASSWORD=YOUR_MAIL_PASSWORD \
  -- docker run -i --rm ghcr.io/buzzer/imap-mcp:0.2.0

Environment

IMAP_HOST (required): IMAP server host name (IMAPS), e.g. imap.example.com
MAIL_USER (required): IMAP login, usually the mail address
MAIL_PASSWORD (required): IMAP password; an app-specific password where the provider requires one
IMAP_PORT (optional, not in the config above): IMAPS port
MAIL_ADDRESS (optional, not in the config above): Own sender address, if it differs from the login
MAIL_FROM_NAME (optional, not in the config above): Display name used as sender of drafts
MAIL_ALIASES (optional, not in the config above): Additional allowed sender addresses, comma-separated; *@example.com allows a whole domain
DRAFTS_FOLDER (optional, not in the config above): Drafts folder, if it is not detected automatically
MARK_READ_ON_READ (optional, not in the config above): read_message marks every message it returns as read
BCC_SELF (optional, not in the config above): Add the sender address as Bcc to every draft

Tools

We don't run packages, so we can't list this server's tools.