NestDaddy

Mailoo - Email MCP Server

io.github.Bitfloo/mailoo ยท v0.3.5

Email MCP server for AI agents: IMAP/SMTP, Gmail, Outlook, calendar, ManageSieve, AI triage, OAuth2.

Connect Runs on your machine

Terminal
claude mcp add mailoo -e MCP_EMAIL_ADDRESS=<MCP_EMAIL_ADDRESS> -e MCP_EMAIL_PASSWORD=<MCP_EMAIL_PASSWORD> -e MCP_EMAIL_IMAP_HOST=<MCP_EMAIL_IMAP_HOST> -e MCP_EMAIL_SMTP_HOST=<MCP_EMAIL_SMTP_HOST> -e MCP_EMAIL_ACCOUNT_NAME=<MCP_EMAIL_ACCOUNT_NAME> -e MCP_EMAIL_FULL_NAME=<MCP_EMAIL_FULL_NAME> -e MCP_EMAIL_USERNAME=<MCP_EMAIL_USERNAME> -e MCP_EMAIL_IMAP_PORT=<MCP_EMAIL_IMAP_PORT> -e MCP_EMAIL_IMAP_TLS=<MCP_EMAIL_IMAP_TLS> -e MCP_EMAIL_IMAP_STARTTLS=<MCP_EMAIL_IMAP_STARTTLS> -e MCP_EMAIL_IMAP_VERIFY_SSL=<MCP_EMAIL_IMAP_VERIFY_SSL> -e MCP_EMAIL_IMAP_DISABLE_IMAP4REV2=<MCP_EMAIL_IMAP_DISABLE_IMAP4REV2> -e MCP_EMAIL_SIEVE_HOST=<MCP_EMAIL_SIEVE_HOST> -e MCP_EMAIL_SIEVE_PORT=<MCP_EMAIL_SIEVE_PORT> -e MCP_EMAIL_SMTP_PORT=<MCP_EMAIL_SMTP_PORT> -e MCP_EMAIL_SMTP_TLS=<MCP_EMAIL_SMTP_TLS> -e MCP_EMAIL_SMTP_STARTTLS=<MCP_EMAIL_SMTP_STARTTLS> -e MCP_EMAIL_SMTP_VERIFY_SSL=<MCP_EMAIL_SMTP_VERIFY_SSL> -e MCP_EMAIL_SMTP_POOL_ENABLED=<MCP_EMAIL_SMTP_POOL_ENABLED> -e MCP_EMAIL_SMTP_POOL_MAX_CONNECTIONS=<MCP_EMAIL_SMTP_POOL_MAX_CONNECTIONS> -e MCP_EMAIL_SMTP_POOL_MAX_MESSAGES=<MCP_EMAIL_SMTP_POOL_MAX_MESSAGES> -e MCP_EMAIL_OAUTH2_PROVIDER=<MCP_EMAIL_OAUTH2_PROVIDER> -e MCP_EMAIL_OAUTH2_CLIENT_ID=<MCP_EMAIL_OAUTH2_CLIENT_ID> -e MCP_EMAIL_OAUTH2_CLIENT_SECRET=<MCP_EMAIL_OAUTH2_CLIENT_SECRET> -e MCP_EMAIL_OAUTH2_REFRESH_TOKEN=<MCP_EMAIL_OAUTH2_REFRESH_TOKEN> -e MCP_EMAIL_RATE_LIMIT=<MCP_EMAIL_RATE_LIMIT> -e MCP_EMAIL_READ_ONLY=<MCP_EMAIL_READ_ONLY> -e MCP_EMAIL_SAVE_TO_SENT=<MCP_EMAIL_SAVE_TO_SENT> -e MCP_EMAIL_WATCHER_ENABLED=<MCP_EMAIL_WATCHER_ENABLED> -e MCP_EMAIL_WATCHER_FOLDERS=<MCP_EMAIL_WATCHER_FOLDERS> -e MCP_EMAIL_WATCHER_IDLE_TIMEOUT=<MCP_EMAIL_WATCHER_IDLE_TIMEOUT> -e MCP_EMAIL_HOOK_ON_NEW_EMAIL=<MCP_EMAIL_HOOK_ON_NEW_EMAIL> -e MCP_EMAIL_HOOK_PRESET=<MCP_EMAIL_HOOK_PRESET> -e MCP_EMAIL_HOOK_AUTO_LABEL=<MCP_EMAIL_HOOK_AUTO_LABEL> -e MCP_EMAIL_HOOK_AUTO_FLAG=<MCP_EMAIL_HOOK_AUTO_FLAG> -e MCP_EMAIL_HOOK_BATCH_DELAY=<MCP_EMAIL_HOOK_BATCH_DELAY> -e MCP_EMAIL_HOOK_CUSTOM_INSTRUCTIONS=<MCP_EMAIL_HOOK_CUSTOM_INSTRUCTIONS> -e MCP_EMAIL_ALERT_DESKTOP=<MCP_EMAIL_ALERT_DESKTOP> -e MCP_EMAIL_ALERT_SOUND=<MCP_EMAIL_ALERT_SOUND> -e MCP_EMAIL_ALERT_URGENCY_THRESHOLD=<MCP_EMAIL_ALERT_URGENCY_THRESHOLD> -e MCP_EMAIL_ALERT_WEBHOOK_URL=<MCP_EMAIL_ALERT_WEBHOOK_URL> -e MCP_EMAIL_ALERT_WEBHOOK_ALLOW_PRIVATE=<MCP_EMAIL_ALERT_WEBHOOK_ALLOW_PRIVATE> -e MCP_EMAIL_HOOK_AUTO_CALENDAR=<MCP_EMAIL_HOOK_AUTO_CALENDAR> -e MCP_EMAIL_HOOK_CALENDAR_NAME=<MCP_EMAIL_HOOK_CALENDAR_NAME> -e MCP_EMAIL_HOOK_CALENDAR_ALARM_MINUTES=<MCP_EMAIL_HOOK_CALENDAR_ALARM_MINUTES> -e MCP_EMAIL_HOOK_CALENDAR_CONFIRM=<MCP_EMAIL_HOOK_CALENDAR_CONFIRM> -e MCP_EMAIL_SYSTEM_ONE_ENABLED=<MCP_EMAIL_SYSTEM_ONE_ENABLED> -e MCP_EMAIL_HTTP_HOST=<MCP_EMAIL_HTTP_HOST> -e MCP_EMAIL_HTTP_TOKEN=<MCP_EMAIL_HTTP_TOKEN> -e MCP_EMAIL_HTTP_ALLOWED_HOSTS=<MCP_EMAIL_HTTP_ALLOWED_HOSTS> -e MCP_EMAIL_DEFAULT_ACCOUNT=<MCP_EMAIL_DEFAULT_ACCOUNT> -e MCP_EMAIL_TOOLSET=<MCP_EMAIL_TOOLSET> -- npx -y @bitfloo/[email protected]
claude_desktop_config.json
{
  "mcpServers": {
    "mailoo": {
      "command": "npx",
      "args": [
        "-y",
        "@bitfloo/[email protected]"
      ],
      "env": {
        "MCP_EMAIL_ADDRESS": "<MCP_EMAIL_ADDRESS>",
        "MCP_EMAIL_PASSWORD": "<MCP_EMAIL_PASSWORD>",
        "MCP_EMAIL_IMAP_HOST": "<MCP_EMAIL_IMAP_HOST>",
        "MCP_EMAIL_SMTP_HOST": "<MCP_EMAIL_SMTP_HOST>",
        "MCP_EMAIL_ACCOUNT_NAME": "<MCP_EMAIL_ACCOUNT_NAME>",
        "MCP_EMAIL_FULL_NAME": "<MCP_EMAIL_FULL_NAME>",
        "MCP_EMAIL_USERNAME": "<MCP_EMAIL_USERNAME>",
        "MCP_EMAIL_IMAP_PORT": "<MCP_EMAIL_IMAP_PORT>",
        "MCP_EMAIL_IMAP_TLS": "<MCP_EMAIL_IMAP_TLS>",
        "MCP_EMAIL_IMAP_STARTTLS": "<MCP_EMAIL_IMAP_STARTTLS>",
        "MCP_EMAIL_IMAP_VERIFY_SSL": "<MCP_EMAIL_IMAP_VERIFY_SSL>",
        "MCP_EMAIL_IMAP_DISABLE_IMAP4REV2": "<MCP_EMAIL_IMAP_DISABLE_IMAP4REV2>",
        "MCP_EMAIL_SIEVE_HOST": "<MCP_EMAIL_SIEVE_HOST>",
        "MCP_EMAIL_SIEVE_PORT": "<MCP_EMAIL_SIEVE_PORT>",
        "MCP_EMAIL_SMTP_PORT": "<MCP_EMAIL_SMTP_PORT>",
        "MCP_EMAIL_SMTP_TLS": "<MCP_EMAIL_SMTP_TLS>",
        "MCP_EMAIL_SMTP_STARTTLS": "<MCP_EMAIL_SMTP_STARTTLS>",
        "MCP_EMAIL_SMTP_VERIFY_SSL": "<MCP_EMAIL_SMTP_VERIFY_SSL>",
        "MCP_EMAIL_SMTP_POOL_ENABLED": "<MCP_EMAIL_SMTP_POOL_ENABLED>",
        "MCP_EMAIL_SMTP_POOL_MAX_CONNECTIONS": "<MCP_EMAIL_SMTP_POOL_MAX_CONNECTIONS>",
        "MCP_EMAIL_SMTP_POOL_MAX_MESSAGES": "<MCP_EMAIL_SMTP_POOL_MAX_MESSAGES>",
        "MCP_EMAIL_OAUTH2_PROVIDER": "<MCP_EMAIL_OAUTH2_PROVIDER>",
        "MCP_EMAIL_OAUTH2_CLIENT_ID": "<MCP_EMAIL_OAUTH2_CLIENT_ID>",
        "MCP_EMAIL_OAUTH2_CLIENT_SECRET": "<MCP_EMAIL_OAUTH2_CLIENT_SECRET>",
        "MCP_EMAIL_OAUTH2_REFRESH_TOKEN": "<MCP_EMAIL_OAUTH2_REFRESH_TOKEN>",
        "MCP_EMAIL_RATE_LIMIT": "<MCP_EMAIL_RATE_LIMIT>",
        "MCP_EMAIL_READ_ONLY": "<MCP_EMAIL_READ_ONLY>",
        "MCP_EMAIL_SAVE_TO_SENT": "<MCP_EMAIL_SAVE_TO_SENT>",
        "MCP_EMAIL_WATCHER_ENABLED": "<MCP_EMAIL_WATCHER_ENABLED>",
        "MCP_EMAIL_WATCHER_FOLDERS": "<MCP_EMAIL_WATCHER_FOLDERS>",
        "MCP_EMAIL_WATCHER_IDLE_TIMEOUT": "<MCP_EMAIL_WATCHER_IDLE_TIMEOUT>",
        "MCP_EMAIL_HOOK_ON_NEW_EMAIL": "<MCP_EMAIL_HOOK_ON_NEW_EMAIL>",
        "MCP_EMAIL_HOOK_PRESET": "<MCP_EMAIL_HOOK_PRESET>",
        "MCP_EMAIL_HOOK_AUTO_LABEL": "<MCP_EMAIL_HOOK_AUTO_LABEL>",
        "MCP_EMAIL_HOOK_AUTO_FLAG": "<MCP_EMAIL_HOOK_AUTO_FLAG>",
        "MCP_EMAIL_HOOK_BATCH_DELAY": "<MCP_EMAIL_HOOK_BATCH_DELAY>",
        "MCP_EMAIL_HOOK_CUSTOM_INSTRUCTIONS": "<MCP_EMAIL_HOOK_CUSTOM_INSTRUCTIONS>",
        "MCP_EMAIL_ALERT_DESKTOP": "<MCP_EMAIL_ALERT_DESKTOP>",
        "MCP_EMAIL_ALERT_SOUND": "<MCP_EMAIL_ALERT_SOUND>",
        "MCP_EMAIL_ALERT_URGENCY_THRESHOLD": "<MCP_EMAIL_ALERT_URGENCY_THRESHOLD>",
        "MCP_EMAIL_ALERT_WEBHOOK_URL": "<MCP_EMAIL_ALERT_WEBHOOK_URL>",
        "MCP_EMAIL_ALERT_WEBHOOK_ALLOW_PRIVATE": "<MCP_EMAIL_ALERT_WEBHOOK_ALLOW_PRIVATE>",
        "MCP_EMAIL_HOOK_AUTO_CALENDAR": "<MCP_EMAIL_HOOK_AUTO_CALENDAR>",
        "MCP_EMAIL_HOOK_CALENDAR_NAME": "<MCP_EMAIL_HOOK_CALENDAR_NAME>",
        "MCP_EMAIL_HOOK_CALENDAR_ALARM_MINUTES": "<MCP_EMAIL_HOOK_CALENDAR_ALARM_MINUTES>",
        "MCP_EMAIL_HOOK_CALENDAR_CONFIRM": "<MCP_EMAIL_HOOK_CALENDAR_CONFIRM>",
        "MCP_EMAIL_SYSTEM_ONE_ENABLED": "<MCP_EMAIL_SYSTEM_ONE_ENABLED>",
        "MCP_EMAIL_HTTP_HOST": "<MCP_EMAIL_HTTP_HOST>",
        "MCP_EMAIL_HTTP_TOKEN": "<MCP_EMAIL_HTTP_TOKEN>",
        "MCP_EMAIL_HTTP_ALLOWED_HOSTS": "<MCP_EMAIL_HTTP_ALLOWED_HOSTS>",
        "MCP_EMAIL_DEFAULT_ACCOUNT": "<MCP_EMAIL_DEFAULT_ACCOUNT>",
        "MCP_EMAIL_TOOLSET": "<MCP_EMAIL_TOOLSET>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "mailoo": {
      "command": "npx",
      "args": [
        "-y",
        "@bitfloo/[email protected]"
      ],
      "env": {
        "MCP_EMAIL_ADDRESS": "<MCP_EMAIL_ADDRESS>",
        "MCP_EMAIL_PASSWORD": "<MCP_EMAIL_PASSWORD>",
        "MCP_EMAIL_IMAP_HOST": "<MCP_EMAIL_IMAP_HOST>",
        "MCP_EMAIL_SMTP_HOST": "<MCP_EMAIL_SMTP_HOST>",
        "MCP_EMAIL_ACCOUNT_NAME": "<MCP_EMAIL_ACCOUNT_NAME>",
        "MCP_EMAIL_FULL_NAME": "<MCP_EMAIL_FULL_NAME>",
        "MCP_EMAIL_USERNAME": "<MCP_EMAIL_USERNAME>",
        "MCP_EMAIL_IMAP_PORT": "<MCP_EMAIL_IMAP_PORT>",
        "MCP_EMAIL_IMAP_TLS": "<MCP_EMAIL_IMAP_TLS>",
        "MCP_EMAIL_IMAP_STARTTLS": "<MCP_EMAIL_IMAP_STARTTLS>",
        "MCP_EMAIL_IMAP_VERIFY_SSL": "<MCP_EMAIL_IMAP_VERIFY_SSL>",
        "MCP_EMAIL_IMAP_DISABLE_IMAP4REV2": "<MCP_EMAIL_IMAP_DISABLE_IMAP4REV2>",
        "MCP_EMAIL_SIEVE_HOST": "<MCP_EMAIL_SIEVE_HOST>",
        "MCP_EMAIL_SIEVE_PORT": "<MCP_EMAIL_SIEVE_PORT>",
        "MCP_EMAIL_SMTP_PORT": "<MCP_EMAIL_SMTP_PORT>",
        "MCP_EMAIL_SMTP_TLS": "<MCP_EMAIL_SMTP_TLS>",
        "MCP_EMAIL_SMTP_STARTTLS": "<MCP_EMAIL_SMTP_STARTTLS>",
        "MCP_EMAIL_SMTP_VERIFY_SSL": "<MCP_EMAIL_SMTP_VERIFY_SSL>",
        "MCP_EMAIL_SMTP_POOL_ENABLED": "<MCP_EMAIL_SMTP_POOL_ENABLED>",
        "MCP_EMAIL_SMTP_POOL_MAX_CONNECTIONS": "<MCP_EMAIL_SMTP_POOL_MAX_CONNECTIONS>",
        "MCP_EMAIL_SMTP_POOL_MAX_MESSAGES": "<MCP_EMAIL_SMTP_POOL_MAX_MESSAGES>",
        "MCP_EMAIL_OAUTH2_PROVIDER": "<MCP_EMAIL_OAUTH2_PROVIDER>",
        "MCP_EMAIL_OAUTH2_CLIENT_ID": "<MCP_EMAIL_OAUTH2_CLIENT_ID>",
        "MCP_EMAIL_OAUTH2_CLIENT_SECRET": "<MCP_EMAIL_OAUTH2_CLIENT_SECRET>",
        "MCP_EMAIL_OAUTH2_REFRESH_TOKEN": "<MCP_EMAIL_OAUTH2_REFRESH_TOKEN>",
        "MCP_EMAIL_RATE_LIMIT": "<MCP_EMAIL_RATE_LIMIT>",
        "MCP_EMAIL_READ_ONLY": "<MCP_EMAIL_READ_ONLY>",
        "MCP_EMAIL_SAVE_TO_SENT": "<MCP_EMAIL_SAVE_TO_SENT>",
        "MCP_EMAIL_WATCHER_ENABLED": "<MCP_EMAIL_WATCHER_ENABLED>",
        "MCP_EMAIL_WATCHER_FOLDERS": "<MCP_EMAIL_WATCHER_FOLDERS>",
        "MCP_EMAIL_WATCHER_IDLE_TIMEOUT": "<MCP_EMAIL_WATCHER_IDLE_TIMEOUT>",
        "MCP_EMAIL_HOOK_ON_NEW_EMAIL": "<MCP_EMAIL_HOOK_ON_NEW_EMAIL>",
        "MCP_EMAIL_HOOK_PRESET": "<MCP_EMAIL_HOOK_PRESET>",
        "MCP_EMAIL_HOOK_AUTO_LABEL": "<MCP_EMAIL_HOOK_AUTO_LABEL>",
        "MCP_EMAIL_HOOK_AUTO_FLAG": "<MCP_EMAIL_HOOK_AUTO_FLAG>",
        "MCP_EMAIL_HOOK_BATCH_DELAY": "<MCP_EMAIL_HOOK_BATCH_DELAY>",
        "MCP_EMAIL_HOOK_CUSTOM_INSTRUCTIONS": "<MCP_EMAIL_HOOK_CUSTOM_INSTRUCTIONS>",
        "MCP_EMAIL_ALERT_DESKTOP": "<MCP_EMAIL_ALERT_DESKTOP>",
        "MCP_EMAIL_ALERT_SOUND": "<MCP_EMAIL_ALERT_SOUND>",
        "MCP_EMAIL_ALERT_URGENCY_THRESHOLD": "<MCP_EMAIL_ALERT_URGENCY_THRESHOLD>",
        "MCP_EMAIL_ALERT_WEBHOOK_URL": "<MCP_EMAIL_ALERT_WEBHOOK_URL>",
        "MCP_EMAIL_ALERT_WEBHOOK_ALLOW_PRIVATE": "<MCP_EMAIL_ALERT_WEBHOOK_ALLOW_PRIVATE>",
        "MCP_EMAIL_HOOK_AUTO_CALENDAR": "<MCP_EMAIL_HOOK_AUTO_CALENDAR>",
        "MCP_EMAIL_HOOK_CALENDAR_NAME": "<MCP_EMAIL_HOOK_CALENDAR_NAME>",
        "MCP_EMAIL_HOOK_CALENDAR_ALARM_MINUTES": "<MCP_EMAIL_HOOK_CALENDAR_ALARM_MINUTES>",
        "MCP_EMAIL_HOOK_CALENDAR_CONFIRM": "<MCP_EMAIL_HOOK_CALENDAR_CONFIRM>",
        "MCP_EMAIL_SYSTEM_ONE_ENABLED": "<MCP_EMAIL_SYSTEM_ONE_ENABLED>",
        "MCP_EMAIL_HTTP_HOST": "<MCP_EMAIL_HTTP_HOST>",
        "MCP_EMAIL_HTTP_TOKEN": "<MCP_EMAIL_HTTP_TOKEN>",
        "MCP_EMAIL_HTTP_ALLOWED_HOSTS": "<MCP_EMAIL_HTTP_ALLOWED_HOSTS>",
        "MCP_EMAIL_DEFAULT_ACCOUNT": "<MCP_EMAIL_DEFAULT_ACCOUNT>",
        "MCP_EMAIL_TOOLSET": "<MCP_EMAIL_TOOLSET>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "mailoo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@bitfloo/[email protected]"
      ],
      "env": {
        "MCP_EMAIL_ADDRESS": "<MCP_EMAIL_ADDRESS>",
        "MCP_EMAIL_PASSWORD": "<MCP_EMAIL_PASSWORD>",
        "MCP_EMAIL_IMAP_HOST": "<MCP_EMAIL_IMAP_HOST>",
        "MCP_EMAIL_SMTP_HOST": "<MCP_EMAIL_SMTP_HOST>",
        "MCP_EMAIL_ACCOUNT_NAME": "<MCP_EMAIL_ACCOUNT_NAME>",
        "MCP_EMAIL_FULL_NAME": "<MCP_EMAIL_FULL_NAME>",
        "MCP_EMAIL_USERNAME": "<MCP_EMAIL_USERNAME>",
        "MCP_EMAIL_IMAP_PORT": "<MCP_EMAIL_IMAP_PORT>",
        "MCP_EMAIL_IMAP_TLS": "<MCP_EMAIL_IMAP_TLS>",
        "MCP_EMAIL_IMAP_STARTTLS": "<MCP_EMAIL_IMAP_STARTTLS>",
        "MCP_EMAIL_IMAP_VERIFY_SSL": "<MCP_EMAIL_IMAP_VERIFY_SSL>",
        "MCP_EMAIL_IMAP_DISABLE_IMAP4REV2": "<MCP_EMAIL_IMAP_DISABLE_IMAP4REV2>",
        "MCP_EMAIL_SIEVE_HOST": "<MCP_EMAIL_SIEVE_HOST>",
        "MCP_EMAIL_SIEVE_PORT": "<MCP_EMAIL_SIEVE_PORT>",
        "MCP_EMAIL_SMTP_PORT": "<MCP_EMAIL_SMTP_PORT>",
        "MCP_EMAIL_SMTP_TLS": "<MCP_EMAIL_SMTP_TLS>",
        "MCP_EMAIL_SMTP_STARTTLS": "<MCP_EMAIL_SMTP_STARTTLS>",
        "MCP_EMAIL_SMTP_VERIFY_SSL": "<MCP_EMAIL_SMTP_VERIFY_SSL>",
        "MCP_EMAIL_SMTP_POOL_ENABLED": "<MCP_EMAIL_SMTP_POOL_ENABLED>",
        "MCP_EMAIL_SMTP_POOL_MAX_CONNECTIONS": "<MCP_EMAIL_SMTP_POOL_MAX_CONNECTIONS>",
        "MCP_EMAIL_SMTP_POOL_MAX_MESSAGES": "<MCP_EMAIL_SMTP_POOL_MAX_MESSAGES>",
        "MCP_EMAIL_OAUTH2_PROVIDER": "<MCP_EMAIL_OAUTH2_PROVIDER>",
        "MCP_EMAIL_OAUTH2_CLIENT_ID": "<MCP_EMAIL_OAUTH2_CLIENT_ID>",
        "MCP_EMAIL_OAUTH2_CLIENT_SECRET": "<MCP_EMAIL_OAUTH2_CLIENT_SECRET>",
        "MCP_EMAIL_OAUTH2_REFRESH_TOKEN": "<MCP_EMAIL_OAUTH2_REFRESH_TOKEN>",
        "MCP_EMAIL_RATE_LIMIT": "<MCP_EMAIL_RATE_LIMIT>",
        "MCP_EMAIL_READ_ONLY": "<MCP_EMAIL_READ_ONLY>",
        "MCP_EMAIL_SAVE_TO_SENT": "<MCP_EMAIL_SAVE_TO_SENT>",
        "MCP_EMAIL_WATCHER_ENABLED": "<MCP_EMAIL_WATCHER_ENABLED>",
        "MCP_EMAIL_WATCHER_FOLDERS": "<MCP_EMAIL_WATCHER_FOLDERS>",
        "MCP_EMAIL_WATCHER_IDLE_TIMEOUT": "<MCP_EMAIL_WATCHER_IDLE_TIMEOUT>",
        "MCP_EMAIL_HOOK_ON_NEW_EMAIL": "<MCP_EMAIL_HOOK_ON_NEW_EMAIL>",
        "MCP_EMAIL_HOOK_PRESET": "<MCP_EMAIL_HOOK_PRESET>",
        "MCP_EMAIL_HOOK_AUTO_LABEL": "<MCP_EMAIL_HOOK_AUTO_LABEL>",
        "MCP_EMAIL_HOOK_AUTO_FLAG": "<MCP_EMAIL_HOOK_AUTO_FLAG>",
        "MCP_EMAIL_HOOK_BATCH_DELAY": "<MCP_EMAIL_HOOK_BATCH_DELAY>",
        "MCP_EMAIL_HOOK_CUSTOM_INSTRUCTIONS": "<MCP_EMAIL_HOOK_CUSTOM_INSTRUCTIONS>",
        "MCP_EMAIL_ALERT_DESKTOP": "<MCP_EMAIL_ALERT_DESKTOP>",
        "MCP_EMAIL_ALERT_SOUND": "<MCP_EMAIL_ALERT_SOUND>",
        "MCP_EMAIL_ALERT_URGENCY_THRESHOLD": "<MCP_EMAIL_ALERT_URGENCY_THRESHOLD>",
        "MCP_EMAIL_ALERT_WEBHOOK_URL": "<MCP_EMAIL_ALERT_WEBHOOK_URL>",
        "MCP_EMAIL_ALERT_WEBHOOK_ALLOW_PRIVATE": "<MCP_EMAIL_ALERT_WEBHOOK_ALLOW_PRIVATE>",
        "MCP_EMAIL_HOOK_AUTO_CALENDAR": "<MCP_EMAIL_HOOK_AUTO_CALENDAR>",
        "MCP_EMAIL_HOOK_CALENDAR_NAME": "<MCP_EMAIL_HOOK_CALENDAR_NAME>",
        "MCP_EMAIL_HOOK_CALENDAR_ALARM_MINUTES": "<MCP_EMAIL_HOOK_CALENDAR_ALARM_MINUTES>",
        "MCP_EMAIL_HOOK_CALENDAR_CONFIRM": "<MCP_EMAIL_HOOK_CALENDAR_CONFIRM>",
        "MCP_EMAIL_SYSTEM_ONE_ENABLED": "<MCP_EMAIL_SYSTEM_ONE_ENABLED>",
        "MCP_EMAIL_HTTP_HOST": "<MCP_EMAIL_HTTP_HOST>",
        "MCP_EMAIL_HTTP_TOKEN": "<MCP_EMAIL_HTTP_TOKEN>",
        "MCP_EMAIL_HTTP_ALLOWED_HOSTS": "<MCP_EMAIL_HTTP_ALLOWED_HOSTS>",
        "MCP_EMAIL_DEFAULT_ACCOUNT": "<MCP_EMAIL_DEFAULT_ACCOUNT>",
        "MCP_EMAIL_TOOLSET": "<MCP_EMAIL_TOOLSET>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

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

Details

Package@bitfloo/[email protected] (NPM, stdio)
First published31 Oct 2026
Last updated31 Oct 2026
Registry nameio.github.Bitfloo/mailoo

More communication servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.