Mailoo MCP Server
by bitflooio.github.Bitfloo/mailoov0.1.8
Mailoo — email MCP server for IMAP, SMTP, and ManageSieve. Multi-account, per-folder profiles.
0Node.jsstdioofficial registry
context tax
queued
security
queued
cold start
queued
freshness
Active1d ago
Install Mailoo MCP server
Install in Claude Code
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_OAUTH2_CLIENT_SECRET='<mcp-email-oauth2-client-secret>' -e MCP_EMAIL_OAUTH2_REFRESH_TOKEN='<mcp-email-oauth2-refresh-token>' -e MCP_EMAIL_ALERT_WEBHOOK_URL='<mcp-email-alert-webhook-url>' -e MCP_EMAIL_HTTP_TOKEN='<mcp-email-http-token>' -- npx -y @bitfloo/mailooInstall in Cursor
{
"mcpServers": {
"mailoo": {
"command": "npx",
"args": [
"-y",
"@bitfloo/mailoo"
],
"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_OAUTH2_CLIENT_SECRET": "<mcp-email-oauth2-client-secret>",
"MCP_EMAIL_OAUTH2_REFRESH_TOKEN": "<mcp-email-oauth2-refresh-token>",
"MCP_EMAIL_ALERT_WEBHOOK_URL": "<mcp-email-alert-webhook-url>",
"MCP_EMAIL_HTTP_TOKEN": "<mcp-email-http-token>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"mailoo": {
"command": "npx",
"args": [
"-y",
"@bitfloo/mailoo"
],
"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_OAUTH2_CLIENT_SECRET": "<mcp-email-oauth2-client-secret>",
"MCP_EMAIL_OAUTH2_REFRESH_TOKEN": "<mcp-email-oauth2-refresh-token>",
"MCP_EMAIL_ALERT_WEBHOOK_URL": "<mcp-email-alert-webhook-url>",
"MCP_EMAIL_HTTP_TOKEN": "<mcp-email-http-token>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"mailoo": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@bitfloo/mailoo"
],
"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_OAUTH2_CLIENT_SECRET": "<mcp-email-oauth2-client-secret>",
"MCP_EMAIL_OAUTH2_REFRESH_TOKEN": "<mcp-email-oauth2-refresh-token>",
"MCP_EMAIL_ALERT_WEBHOOK_URL": "<mcp-email-alert-webhook-url>",
"MCP_EMAIL_HTTP_TOKEN": "<mcp-email-http-token>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"mailoo": {
"command": "npx",
"args": [
"-y",
"@bitfloo/mailoo"
],
"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_OAUTH2_CLIENT_SECRET": "<mcp-email-oauth2-client-secret>",
"MCP_EMAIL_OAUTH2_REFRESH_TOKEN": "<mcp-email-oauth2-refresh-token>",
"MCP_EMAIL_ALERT_WEBHOOK_URL": "<mcp-email-alert-webhook-url>",
"MCP_EMAIL_HTTP_TOKEN": "<mcp-email-http-token>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| MCP_EMAIL_ADDRESS | yes | — | Email address. Required for the environment-variable account. |
| MCP_EMAIL_PASSWORD | — | yes | Password or app password. Required unless MCP_EMAIL_OAUTH2_PROVIDER is set. |
| 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 | — | — | 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 | — | yes | OAuth2 client secret. |
| MCP_EMAIL_OAUTH2_REFRESH_TOKEN | — | yes | 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 | — | yes | 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 | — | yes | 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 ::. |
Freshness
Active — last maintenance signal 1d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-08 · 1d ago · GitHub
Latest release
2026-10-07 · 2d ago · GitHub · v0.1.8
Package published
no data · npm/PyPI
Registry entry updated
2026-10-07 · 2d ago · official registry · v0.1.8
FAQ
›How do I install the Mailoo MCP server in Claude Code?
Run: 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_OAUTH2_CLIENT_SECRET='<mcp-email-oauth2-client-secret>' -e MCP_EMAIL_OAUTH2_REFRESH_TOKEN='<mcp-email-oauth2-refresh-token>' -e MCP_EMAIL_ALERT_WEBHOOK_URL='<mcp-email-alert-webhook-url>' -e MCP_EMAIL_HTTP_TOKEN='<mcp-email-http-token>' -- npx -y @bitfloo/mailoo. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Mailoo require an API key?
Yes. It expects MCP_EMAIL_ADDRESS, MCP_EMAIL_IMAP_HOST, MCP_EMAIL_SMTP_HOST, MCP_EMAIL_PASSWORD, MCP_EMAIL_OAUTH2_CLIENT_SECRET, MCP_EMAIL_OAUTH2_REFRESH_TOKEN, MCP_EMAIL_ALERT_WEBHOOK_URL, MCP_EMAIL_HTTP_TOKEN, of which 5 are secrets.
›Can I use Mailoo as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Mailoo in the official MCP registry?
Yes, as io.github.Bitfloo/mailoo.
Alternatives to Mailoo
Other email MCP servers.
Inbox ZeroActiveInbox Zero features on top of Gmail, such as finding emails that need a reply or follow-up.
Google WorkspaceActiveGoogle Workspace integration covering Calendar, Drive, Gmail, Docs, Forms, Chat, Slides and Sheets.
OpenOSINTActiveAI-powered OSINT agent & MCP server. 21 tools: email, breach, IP, WHOIS, DNS, Shodan, GitHub & more.
emailmdActiveWrite and preview emails: render Markdown into email-safe HTML for Outlook and Gmail, lint drafts for deliverability and get a live preview link.
Microsoft 365ActiveMCP server that connects to the whole Microsoft 365 suite (Microsoft Office, Outlook, Excel) using Graph API (including mail, files, calendar)
GsuiteAbandonedIntegration with Gmail and Google Calendar.