io.github.Bitfloo/mailoo MCP Server

io.github.Bitfloo/mailoo

Repository Registry

What is the io.github.Bitfloo/mailoo MCP server?

Mailoo — email MCP server for IMAP, SMTP, and ManageSieve. Multi-account, per-folder profiles.

How to install io.github.Bitfloo/mailoo

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

MCP_EMAIL_ADDRESS
required
Email address. Required for the environment-variable account.
MCP_EMAIL_PASSWORD
secret
Password or app password. Required unless MCP_EMAIL_OAUTH2_PROVIDER is set.
MCP_EMAIL_IMAP_HOST
required
IMAP server hostname.
MCP_EMAIL_SMTP_HOST
required
SMTP server hostname.
MCP_EMAIL_ACCOUNT_NAME
Account name. Defaults to default.
MCP_EMAIL_FULL_NAME
Display name on sent mail.
MCP_EMAIL_USERNAME
Login username. Defaults to the email address.
MCP_EMAIL_IMAP_PORT
IMAP port. Defaults to 993.
MCP_EMAIL_IMAP_TLS
Set to false to turn off implicit IMAP TLS. Defaults to true.
MCP_EMAIL_IMAP_STARTTLS
Set to true to upgrade IMAP with STARTTLS. Defaults to false.
MCP_EMAIL_IMAP_VERIFY_SSL
Set to false to skip IMAP certificate verification. Defaults to true.
MCP_EMAIL_IMAP_DISABLE_IMAP4REV2
Set to true to force IMAP4rev1 SEARCH.
MCP_EMAIL_SIEVE_HOST
ManageSieve hostname. Defaults to the IMAP host.
MCP_EMAIL_SIEVE_PORT
ManageSieve port. Defaults to 4190.
MCP_EMAIL_SMTP_PORT
SMTP port. Defaults to 465.
MCP_EMAIL_SMTP_TLS
Set to false to turn off implicit SMTP TLS. Defaults to true.
MCP_EMAIL_SMTP_STARTTLS
Set to true to upgrade SMTP with STARTTLS. Defaults to false.
MCP_EMAIL_SMTP_VERIFY_SSL
Set to false to skip SMTP certificate verification. Defaults to true.
MCP_EMAIL_SMTP_POOL_ENABLED
Set to false to disable SMTP connection pooling. Defaults to true.
MCP_EMAIL_SMTP_POOL_MAX_CONNECTIONS
Maximum pooled SMTP connections. Defaults to 1.
MCP_EMAIL_SMTP_POOL_MAX_MESSAGES
Maximum messages per pooled SMTP connection. Defaults to 100.
MCP_EMAIL_OAUTH2_PROVIDER
OAuth2 provider: google, microsoft, or custom.
MCP_EMAIL_OAUTH2_CLIENT_ID
OAuth2 client id.
MCP_EMAIL_OAUTH2_CLIENT_SECRET
secret
OAuth2 client secret.
MCP_EMAIL_OAUTH2_REFRESH_TOKEN
secret
OAuth2 refresh token.
MCP_EMAIL_RATE_LIMIT
Maximum sends per minute. Defaults to 10.
MCP_EMAIL_READ_ONLY
Set to true to omit write tools and mailbox writers.
MCP_EMAIL_SAVE_TO_SENT
Set to false to skip the IMAP Sent copy after SMTP. Defaults to true.
MCP_EMAIL_WATCHER_ENABLED
Set to true to start the IMAP IDLE watcher.
MCP_EMAIL_WATCHER_FOLDERS
Comma-separated folders to watch. Defaults to INBOX.
MCP_EMAIL_WATCHER_IDLE_TIMEOUT
IMAP IDLE timeout in seconds. Defaults to 1740.
MCP_EMAIL_HOOK_ON_NEW_EMAIL
What to do on arrival: triage, notify, or none.
MCP_EMAIL_HOOK_PRESET
Hook preset: inbox-zero, gtd, priority-focus, notification-only, or custom.
MCP_EMAIL_HOOK_AUTO_LABEL
Set to true to apply labels from hook triage.
MCP_EMAIL_HOOK_AUTO_FLAG
Set to true to flag mail from hook triage.
MCP_EMAIL_HOOK_BATCH_DELAY
Seconds to batch arrivals before hooks run. Defaults to 5.
MCP_EMAIL_HOOK_CUSTOM_INSTRUCTIONS
Extra instructions appended to the hook preset.
MCP_EMAIL_ALERT_DESKTOP
Set to true for desktop notifications.
MCP_EMAIL_ALERT_SOUND
Set to true to play a sound with desktop notifications.
MCP_EMAIL_ALERT_URGENCY_THRESHOLD
Minimum urgency for an alert: urgent, high, normal, or low.
MCP_EMAIL_ALERT_WEBHOOK_URL
secret
HTTP or HTTPS URL that receives alert POSTs.
MCP_EMAIL_ALERT_WEBHOOK_ALLOW_PRIVATE
Set to true to allow webhook targets on a LAN, VPN, or tailnet.
MCP_EMAIL_HOOK_AUTO_CALENDAR
Set to true to create calendar events from hook triage.
MCP_EMAIL_HOOK_CALENDAR_NAME
Calendar name for automatic events.
MCP_EMAIL_HOOK_CALENDAR_ALARM_MINUTES
Minutes before an automatic event to alarm. Defaults to 15.
MCP_EMAIL_HOOK_CALENDAR_CONFIRM
Set to false to skip confirming automatic calendar events. Defaults to true.
MCP_EMAIL_SYSTEM_ONE_ENABLED
Set to true to classify residue mail with System One. Off by default.
MCP_EMAIL_HTTP_HOST
HTTP listen address. Defaults to loopback. The host argument wins.
MCP_EMAIL_HTTP_TOKEN
secret
Bearer token. Required when the HTTP listen address is not loopback or MCP_EMAIL_HTTP_ALLOWED_HOSTS lists a non-loopback name.
MCP_EMAIL_HTTP_ALLOWED_HOSTS
Comma-separated Host names. Required for 0.0.0.0 and ::.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mailoo": {
      "command": "npx",
      "args": [
        "-y",
        "@bitfloo/mailoo",
        "-y"
      ],
      "env": {
        "MCP_EMAIL_ADDRESS": "<YOUR_MCP_EMAIL_ADDRESS>",
        "MCP_EMAIL_PASSWORD": "<YOUR_MCP_EMAIL_PASSWORD>",
        "MCP_EMAIL_IMAP_HOST": "<YOUR_MCP_EMAIL_IMAP_HOST>",
        "MCP_EMAIL_SMTP_HOST": "<YOUR_MCP_EMAIL_SMTP_HOST>",
        "MCP_EMAIL_ACCOUNT_NAME": "<YOUR_MCP_EMAIL_ACCOUNT_NAME>",
        "MCP_EMAIL_FULL_NAME": "<YOUR_MCP_EMAIL_FULL_NAME>",
        "MCP_EMAIL_USERNAME": "<YOUR_MCP_EMAIL_USERNAME>",
        "MCP_EMAIL_IMAP_PORT": "<YOUR_MCP_EMAIL_IMAP_PORT>",
        "MCP_EMAIL_IMAP_TLS": "<YOUR_MCP_EMAIL_IMAP_TLS>",
        "MCP_EMAIL_IMAP_STARTTLS": "<YOUR_MCP_EMAIL_IMAP_STARTTLS>",
        "MCP_EMAIL_IMAP_VERIFY_SSL": "<YOUR_MCP_EMAIL_IMAP_VERIFY_SSL>",
        "MCP_EMAIL_IMAP_DISABLE_IMAP4REV2": "<YOUR_MCP_EMAIL_IMAP_DISABLE_IMAP4REV2>",
        "MCP_EMAIL_SIEVE_HOST": "<YOUR_MCP_EMAIL_SIEVE_HOST>",
        "MCP_EMAIL_SIEVE_PORT": "<YOUR_MCP_EMAIL_SIEVE_PORT>",
        "MCP_EMAIL_SMTP_PORT": "<YOUR_MCP_EMAIL_SMTP_PORT>",
        "MCP_EMAIL_SMTP_TLS": "<YOUR_MCP_EMAIL_SMTP_TLS>",
        "MCP_EMAIL_SMTP_STARTTLS": "<YOUR_MCP_EMAIL_SMTP_STARTTLS>",
        "MCP_EMAIL_SMTP_VERIFY_SSL": "<YOUR_MCP_EMAIL_SMTP_VERIFY_SSL>",
        "MCP_EMAIL_SMTP_POOL_ENABLED": "<YOUR_MCP_EMAIL_SMTP_POOL_ENABLED>",
        "MCP_EMAIL_SMTP_POOL_MAX_CONNECTIONS": "<YOUR_MCP_EMAIL_SMTP_POOL_MAX_CONNECTIONS>",
        "MCP_EMAIL_SMTP_POOL_MAX_MESSAGES": "<YOUR_MCP_EMAIL_SMTP_POOL_MAX_MESSAGES>",
        "MCP_EMAIL_OAUTH2_PROVIDER": "<YOUR_MCP_EMAIL_OAUTH2_PROVIDER>",
        "MCP_EMAIL_OAUTH2_CLIENT_ID": "<YOUR_MCP_EMAIL_OAUTH2_CLIENT_ID>",
        "MCP_EMAIL_OAUTH2_CLIENT_SECRET": "<YOUR_MCP_EMAIL_OAUTH2_CLIENT_SECRET>",
        "MCP_EMAIL_OAUTH2_REFRESH_TOKEN": "<YOUR_MCP_EMAIL_OAUTH2_REFRESH_TOKEN>",
        "MCP_EMAIL_RATE_LIMIT": "<YOUR_MCP_EMAIL_RATE_LIMIT>",
        "MCP_EMAIL_READ_ONLY": "<YOUR_MCP_EMAIL_READ_ONLY>",
        "MCP_EMAIL_SAVE_TO_SENT": "<YOUR_MCP_EMAIL_SAVE_TO_SENT>",
        "MCP_EMAIL_WATCHER_ENABLED": "<YOUR_MCP_EMAIL_WATCHER_ENABLED>",
        "MCP_EMAIL_WATCHER_FOLDERS": "<YOUR_MCP_EMAIL_WATCHER_FOLDERS>",
        "MCP_EMAIL_WATCHER_IDLE_TIMEOUT": "<YOUR_MCP_EMAIL_WATCHER_IDLE_TIMEOUT>",
        "MCP_EMAIL_HOOK_ON_NEW_EMAIL": "<YOUR_MCP_EMAIL_HOOK_ON_NEW_EMAIL>",
        "MCP_EMAIL_HOOK_PRESET": "<YOUR_MCP_EMAIL_HOOK_PRESET>",
        "MCP_EMAIL_HOOK_AUTO_LABEL": "<YOUR_MCP_EMAIL_HOOK_AUTO_LABEL>",
        "MCP_EMAIL_HOOK_AUTO_FLAG": "<YOUR_MCP_EMAIL_HOOK_AUTO_FLAG>",
        "MCP_EMAIL_HOOK_BATCH_DELAY": "<YOUR_MCP_EMAIL_HOOK_BATCH_DELAY>",
        "MCP_EMAIL_HOOK_CUSTOM_INSTRUCTIONS": "<YOUR_MCP_EMAIL_HOOK_CUSTOM_INSTRUCTIONS>",
        "MCP_EMAIL_ALERT_DESKTOP": "<YOUR_MCP_EMAIL_ALERT_DESKTOP>",
        "MCP_EMAIL_ALERT_SOUND": "<YOUR_MCP_EMAIL_ALERT_SOUND>",
        "MCP_EMAIL_ALERT_URGENCY_THRESHOLD": "<YOUR_MCP_EMAIL_ALERT_URGENCY_THRESHOLD>",
        "MCP_EMAIL_ALERT_WEBHOOK_URL": "<YOUR_MCP_EMAIL_ALERT_WEBHOOK_URL>",
        "MCP_EMAIL_ALERT_WEBHOOK_ALLOW_PRIVATE": "<YOUR_MCP_EMAIL_ALERT_WEBHOOK_ALLOW_PRIVATE>",
        "MCP_EMAIL_HOOK_AUTO_CALENDAR": "<YOUR_MCP_EMAIL_HOOK_AUTO_CALENDAR>",
        "MCP_EMAIL_HOOK_CALENDAR_NAME": "<YOUR_MCP_EMAIL_HOOK_CALENDAR_NAME>",
        "MCP_EMAIL_HOOK_CALENDAR_ALARM_MINUTES": "<YOUR_MCP_EMAIL_HOOK_CALENDAR_ALARM_MINUTES>",
        "MCP_EMAIL_HOOK_CALENDAR_CONFIRM": "<YOUR_MCP_EMAIL_HOOK_CALENDAR_CONFIRM>",
        "MCP_EMAIL_SYSTEM_ONE_ENABLED": "<YOUR_MCP_EMAIL_SYSTEM_ONE_ENABLED>",
        "MCP_EMAIL_HTTP_HOST": "<YOUR_MCP_EMAIL_HTTP_HOST>",
        "MCP_EMAIL_HTTP_TOKEN": "<YOUR_MCP_EMAIL_HTTP_TOKEN>",
        "MCP_EMAIL_HTTP_ALLOWED_HOSTS": "<YOUR_MCP_EMAIL_HTTP_ALLOWED_HOSTS>"
      }
    }
  }
}