mailoo MCP Setup & Guide

{
  "id": "io.github.Bitfloo/mailoo",
  "type": "mcp-server",
  "version": "0.1.7",
  "displayName": "mailoo",
  "description": "Mailoo — email MCP server for IMAP, SMTP, and ManageSieve. Multi-account, per-folder profiles.",
  "repository": {
    "url": "https://github.com/Bitfloo/mailoo.git",
    "source": "github"
  },
  "distribution": {
    "packages": [
      {
        "registryType": "npm",
        "identifier": "@bitfloo/mailoo",
        "version": "0.1.7",
        "runtimeHint": "npx",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "MCP_EMAIL_ADDRESS",
            "description": "Email address. Required for the environment-variable account.",
            "isRequired": true
          },
          {
            "name": "MCP_EMAIL_PASSWORD",
            "description": "Password or app password. Required unless MCP_EMAIL_OAUTH2_PROVIDER is set.",
            "isSecret": true
          },
          {
            "name": "MCP_EMAIL_IMAP_HOST",
            "description": "IMAP server hostname.",
            "isRequired": true
          },
          {
            "name": "MCP_EMAIL_SMTP_HOST",
            "description": "SMTP server hostname.",
            "isRequired": true
          },
          {
            "name": "MCP_EMAIL_ACCOUNT_NAME",
            "description": "Account name. Defaults to default."
          },
          {
            "name": "MCP_EMAIL_FULL_NAME",
            "description": "Display name on sent mail."
          },
          {
            "name": "MCP_EMAIL_USERNAME",
            "description": "Login username. Defaults to the email address."
          },
          {
            "name": "MCP_EMAIL_IMAP_PORT",
            "description": "IMAP port. Defaults to 993."
          },
          {
            "name": "MCP_EMAIL_IMAP_TLS",
            "description": "Set to false to turn off implicit IMAP TLS. Defaults to true."
          },
          {
            "name": "MCP_EMAIL_IMAP_STARTTLS",
            "description": "Set to true to upgrade IMAP with STARTTLS. Defaults to false."
          },
          {
            "name": "MCP_EMAIL_IMAP_VERIFY_SSL",
            "description": "Set to false to skip IMAP certificate verification. Defaults to true."
          },
          {
            "name": "MCP_EMAIL_IMAP_DISABLE_IMAP4REV2",
            "description": "Set to true to force IMAP4rev1 SEARCH."
          },
          {
            "name": "MCP_EMAIL_SIEVE_HOST",
            "description": "ManageSieve hostname. Defaults to the IMAP host."
          },
          {
            "name": "MCP_EMAIL_SIEVE_PORT",
            "description": "ManageSieve port. Defaults to 4190."
          },
          {
            "name": "MCP_EMAIL_SMTP_PORT",
            "description": "SMTP port. Defaults to 465."
          },
          {
            "name": "MCP_EMAIL_SMTP_TLS",
            "description": "Set to false to turn off implicit SMTP TLS. Defaults to true."
          },
          {
            "name": "MCP_EMAIL_SMTP_STARTTLS",
            "description": "Set to true to upgrade SMTP with STARTTLS. Defaults to false."
          },
          {
            "name": "MCP_EMAIL_SMTP_VERIFY_SSL",
            "description": "Set to false to skip SMTP certificate verification. Defaults to true."
          },
          {
            "name": "MCP_EMAIL_SMTP_POOL_ENABLED",
            "description": "Set to false to disable SMTP connection pooling. Defaults to true."
          },
          {
            "name": "MCP_EMAIL_SMTP_POOL_MAX_CONNECTIONS",
            "description": "Maximum pooled SMTP connections. Defaults to 1."
          },
          {
            "name": "MCP_EMAIL_SMTP_POOL_MAX_MESSAGES",
            "description": "Maximum messages per pooled SMTP connection. Defaults to 100."
          },
          {
            "name": "MCP_EMAIL_OAUTH2_PROVIDER",
            "description": "OAuth2 provider: google, microsoft, or custom."
          },
          {
            "name": "MCP_EMAIL_OAUTH2_CLIENT_ID",
            "description": "OAuth2 client id."
          },
          {
            "name": "MCP_EMAIL_OAUTH2_CLIENT_SECRET",
            "description": "OAuth2 client secret.",
            "isSecret": true
          },
          {
            "name": "MCP_EMAIL_OAUTH2_REFRESH_TOKEN",
            "description": "OAuth2 refresh token.",
            "isSecret": true
          },
          {
            "name": "MCP_EMAIL_RATE_LIMIT",
            "description": "Maximum sends per minute. Defaults to 10."
          },
          {
            "name": "MCP_EMAIL_READ_ONLY",
            "description": "Set to true to omit write tools and mailbox writers."
          },
          {
            "name": "MCP_EMAIL_SAVE_TO_SENT",
            "description": "Set to false to skip the IMAP Sent copy after SMTP. Defaults to true."
          },
          {
            "name": "MCP_EMAIL_WATCHER_ENABLED",
            "description": "Set to true to start the IMAP IDLE watcher."
          },
          {
            "name": "MCP_EMAIL_WATCHER_FOLDERS",
            "description": "Comma-separated folders to watch. Defaults to INBOX."
          },
          {
            "name": "MCP_EMAIL_WATCHER_IDLE_TIMEOUT",
            "description": "IMAP IDLE timeout in seconds. Defaults to 1740."
          },
          {
            "name": "MCP_EMAIL_HOOK_ON_NEW_EMAIL",
            "description": "What to do on arrival: triage, notify, or none."
          },
          {
            "name": "MCP_EMAIL_HOOK_PRESET",
            "description": "Hook preset: inbox-zero, gtd, priority-focus, notification-only, or custom."
          },
          {
            "name": "MCP_EMAIL_HOOK_AUTO_LABEL",
            "description": "Set to true to apply labels from hook triage."
          },
          {
            "name": "MCP_EMAIL_HOOK_AUTO_FLAG",
            "description": "Set to true to flag mail from hook triage."
          },
          {
            "name": "MCP_EMAIL_HOOK_BATCH_DELAY",
            "description": "Seconds to batch arrivals before hooks run. Defaults to 5."
          },
          {
            "name": "MCP_EMAIL_HOOK_CUSTOM_INSTRUCTIONS",
            "description": "Extra instructions appended to the hook preset."
          },
          {
            "name": "MCP_EMAIL_ALERT_DESKTOP",
            "description": "Set to true for desktop notifications."
          },
          {
            "name": "MCP_EMAIL_ALERT_SOUND",
            "description": "Set to true to play a sound with desktop notifications."
          },
          {
            "name": "MCP_EMAIL_ALERT_URGENCY_THRESHOLD",
            "description": "Minimum urgency for an alert: urgent, high, normal, or low."
          },
          {
            "name": "MCP_EMAIL_ALERT_WEBHOOK_URL",
            "description": "HTTP or HTTPS URL that receives alert POSTs.",
            "isSecret": true
          },
          {
            "name": "MCP_EMAIL_ALERT_WEBHOOK_ALLOW_PRIVATE",
            "description": "Set to true to allow webhook targets on a LAN, VPN, or tailnet."
          },
          {
            "name": "MCP_EMAIL_HOOK_AUTO_CALENDAR",
            "description": "Set to true to create calendar events from hook triage."
          },
          {
            "name": "MCP_EMAIL_HOOK_CALENDAR_NAME",
            "description": "Calendar name for automatic events."
          },
          {
            "name": "MCP_EMAIL_HOOK_CALENDAR_ALARM_MINUTES",
            "description": "Minutes before an automatic event to alarm. Defaults to 15."
          },
          {
            "name": "MCP_EMAIL_HOOK_CALENDAR_CONFIRM",
            "description": "Set to false to skip confirming automatic calendar events. Defaults to true."
          },
          {
            "name": "MCP_EMAIL_SYSTEM_ONE_ENABLED",
            "description": "Set to true to classify residue mail with System One. Off by default."
          },
          {
            "name": "MCP_EMAIL_HTTP_HOST",
            "description": "HTTP listen address. Defaults to loopback. The host argument wins."
          },
          {
            "name": "MCP_EMAIL_HTTP_TOKEN",
            "description": "Bearer token. Required when the HTTP listen address is not loopback or MCP_EMAIL_HTTP_ALLOWED_HOSTS lists a non-loopback name.",
            "isSecret": true
          },
          {
            "name": "MCP_EMAIL_HTTP_ALLOWED_HOSTS",
            "description": "Comma-separated Host names. Required for 0.0.0.0 and ::."
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode",
    "trae",
    "cherry-studio",
    "lingma",
    "windsurf",
    "cline",
    "workbuddy"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.Bitfloo/mailoo",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.Bitfloo%2Fmailoo/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}