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

How do I install mailoo?

Pick a client above and copy the generated config. Cursor and VS Code also have a deep link when the server can run locally or remotely.

No. Registry-listed is not the same as vendor-official. Read the methodology for the difference.

How is the trust score calculated?

This listing scores 59 (Fair). The formula is published on the methodology page.

mailoo MCP Server — Install for Claude, Cursor & VS Code

Loading the directory

Install

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

{
  "mcpServers": {
    "bitfloo-mailoo": {
      "command": "npx",
      "args": [
        "-y",
        "@bitfloo/mailoo@0.2.1"
      ],
      "env": {
        "MCP_EMAIL_ADDRESS": "",
        "MCP_EMAIL_PASSWORD": "YOUR_MCP_EMAIL_PASSWORD",
        "MCP_EMAIL_IMAP_HOST": "",
        "MCP_EMAIL_SMTP_HOST": "",
        "MCP_EMAIL_ACCOUNT_NAME": "",
        "MCP_EMAIL_FULL_NAME": "",
        "MCP_EMAIL_USERNAME": "",
        "MCP_EMAIL_IMAP_PORT": "",
        "MCP_EMAIL_IMAP_TLS": "",
        "MCP_EMAIL_IMAP_STARTTLS": "",
        "MCP_EMAIL_IMAP_VERIFY_SSL": "",
        "MCP_EMAIL_IMAP_DISABLE_IMAP4REV2": "",
        "MCP_EMAIL_SIEVE_HOST": "",
        "MCP_EMAIL_SIEVE_PORT": "",
        "MCP_EMAIL_SMTP_PORT": "",
        "MCP_EMAIL_SMTP_TLS": "",
        "MCP_EMAIL_SMTP_STARTTLS": "",
        "MCP_EMAIL_SMTP_VERIFY_SSL": "",
        "MCP_EMAIL_SMTP_POOL_ENABLED": "",
        "MCP_EMAIL_SMTP_POOL_MAX_CONNECTIONS": "",
        "MCP_EMAIL_SMTP_POOL_MAX_MESSAGES": "",
        "MCP_EMAIL_OAUTH2_PROVIDER": "",
        "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": "",
        "MCP_EMAIL_READ_ONLY": "",
        "MCP_EMAIL_SAVE_TO_SENT": "",
        "MCP_EMAIL_WATCHER_ENABLED": "",
        "MCP_EMAIL_WATCHER_FOLDERS": "",
        "MCP_EMAIL_WATCHER_IDLE_TIMEOUT": "",
        "MCP_EMAIL_HOOK_ON_NEW_EMAIL": "",
        "MCP_EMAIL_HOOK_PRESET": "",
        "MCP_EMAIL_HOOK_AUTO_LABEL": "",
        "MCP_EMAIL_HOOK_AUTO_FLAG": "",
        "MCP_EMAIL_HOOK_BATCH_DELAY": "",
        "MCP_EMAIL_HOOK_CUSTOM_INSTRUCTIONS": "",
        "MCP_EMAIL_ALERT_DESKTOP": "",
        "MCP_EMAIL_ALERT_SOUND": "",
        "MCP_EMAIL_ALERT_URGENCY_THRESHOLD": "",
        "MCP_EMAIL_ALERT_WEBHOOK_URL": "YOUR_MCP_EMAIL_ALERT_WEBHOOK_URL",
        "MCP_EMAIL_ALERT_WEBHOOK_ALLOW_PRIVATE": "",
        "MCP_EMAIL_HOOK_AUTO_CALENDAR": "",
        "MCP_EMAIL_HOOK_CALENDAR_NAME": "",
        "MCP_EMAIL_HOOK_CALENDAR_ALARM_MINUTES": "",
        "MCP_EMAIL_HOOK_CALENDAR_CONFIRM": "",
        "MCP_EMAIL_SYSTEM_ONE_ENABLED": "",
        "MCP_EMAIL_HTTP_HOST": "",
        "MCP_EMAIL_HTTP_TOKEN": "YOUR_MCP_EMAIL_HTTP_TOKEN",
        "MCP_EMAIL_HTTP_ALLOWED_HOSTS": ""
      }
    }
  }
}

Install guide

Environment

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

Name

Required

Notes

MCP_EMAIL_ADDRESS

Yes

Email address. Required for the environment-variable account.

MCP_EMAIL_PASSWORD

Password or app password. Required unless MCP_EMAIL_OAUTH2_PROVIDER is set. Secret.

MCP_EMAIL_IMAP_HOST

Yes

IMAP server hostname.

MCP_EMAIL_SMTP_HOST

Yes

SMTP server hostname.

MCP_EMAIL_ACCOUNT_NAME

Account name. Defaults to default.

MCP_EMAIL_FULL_NAME

Display name on sent mail.

MCP_EMAIL_USERNAME

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

OAuth2 client secret. Secret.

MCP_EMAIL_OAUTH2_REFRESH_TOKEN

OAuth2 refresh token. Secret.

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

HTTP or HTTPS URL that receives alert POSTs. Secret.

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

Bearer token. Required when the HTTP listen address is not loopback or MCP_EMAIL_HTTP_ALLOWED_HOSTS lists a non-loopback name. Secret.

MCP_EMAIL_HTTP_ALLOWED_HOSTS

Comma-separated Host names. Required for 0.0.0.0 and ::.

mailoo MCP Server

Install

Related servers

XposedOrNot Breach Intelligence

Onyx MCP

Environment

Tools

About

FAQ

Reviews

AI Tag Debugger

Fluxmail

SandboxAPIs

SRIFT