Email MCP server for AI agents: IMAP/SMTP, Gmail, Outlook, calendar, ManageSieve, AI triage, OAuth2.
To add Mailoo - Email MCP Server to Claude, run the install command below or copy the ready-made config for Claude Code, Claude Desktop, Cursor and VS Code further down. Restart your client after adding it and its tools show up in your next conversation. It needs 52 environment variables, listed below.
Install
npx -y @bitfloo/mailoo@0.3.5Environment variables
MCP_EMAIL_ADDRESSSet in your MCP configMCP_EMAIL_PASSWORDSet in your MCP configMCP_EMAIL_IMAP_HOSTSet in your MCP configMCP_EMAIL_SMTP_HOSTSet in your MCP configMCP_EMAIL_ACCOUNT_NAMESet in your MCP configMCP_EMAIL_FULL_NAMESet in your MCP configMCP_EMAIL_USERNAMESet in your MCP configMCP_EMAIL_IMAP_PORTSet in your MCP configMCP_EMAIL_IMAP_TLSSet in your MCP configMCP_EMAIL_IMAP_STARTTLSSet in your MCP configMCP_EMAIL_IMAP_VERIFY_SSLSet in your MCP configMCP_EMAIL_IMAP_DISABLE_IMAP4REV2Set in your MCP configMCP_EMAIL_SIEVE_HOSTSet in your MCP configMCP_EMAIL_SIEVE_PORTSet in your MCP configMCP_EMAIL_SMTP_PORTSet in your MCP configMCP_EMAIL_SMTP_TLSSet in your MCP configMCP_EMAIL_SMTP_STARTTLSSet in your MCP configMCP_EMAIL_SMTP_VERIFY_SSLSet in your MCP configMCP_EMAIL_SMTP_POOL_ENABLEDSet in your MCP configMCP_EMAIL_SMTP_POOL_MAX_CONNECTIONSSet in your MCP configMCP_EMAIL_SMTP_POOL_MAX_MESSAGESSet in your MCP configMCP_EMAIL_OAUTH2_PROVIDERSet in your MCP configMCP_EMAIL_OAUTH2_CLIENT_IDSet in your MCP configMCP_EMAIL_OAUTH2_CLIENT_SECRETSet in your MCP configMCP_EMAIL_OAUTH2_REFRESH_TOKENSet in your MCP configMCP_EMAIL_RATE_LIMITSet in your MCP configMCP_EMAIL_READ_ONLYSet in your MCP configMCP_EMAIL_SAVE_TO_SENTSet in your MCP configMCP_EMAIL_WATCHER_ENABLEDSet in your MCP configMCP_EMAIL_WATCHER_FOLDERSSet in your MCP configMCP_EMAIL_WATCHER_IDLE_TIMEOUTSet in your MCP configMCP_EMAIL_HOOK_ON_NEW_EMAILSet in your MCP configMCP_EMAIL_HOOK_PRESETSet in your MCP configMCP_EMAIL_HOOK_AUTO_LABELSet in your MCP configMCP_EMAIL_HOOK_AUTO_FLAGSet in your MCP configMCP_EMAIL_HOOK_BATCH_DELAYSet in your MCP configMCP_EMAIL_HOOK_CUSTOM_INSTRUCTIONSSet in your MCP configMCP_EMAIL_ALERT_DESKTOPSet in your MCP configMCP_EMAIL_ALERT_SOUNDSet in your MCP configMCP_EMAIL_ALERT_URGENCY_THRESHOLDSet in your MCP configMCP_EMAIL_ALERT_WEBHOOK_URLSet in your MCP configMCP_EMAIL_ALERT_WEBHOOK_ALLOW_PRIVATESet in your MCP configMCP_EMAIL_HOOK_AUTO_CALENDARSet in your MCP configMCP_EMAIL_HOOK_CALENDAR_NAMESet in your MCP configMCP_EMAIL_HOOK_CALENDAR_ALARM_MINUTESSet in your MCP configMCP_EMAIL_HOOK_CALENDAR_CONFIRMSet in your MCP configMCP_EMAIL_SYSTEM_ONE_ENABLEDSet in your MCP configMCP_EMAIL_HTTP_HOSTSet in your MCP configMCP_EMAIL_HTTP_TOKENSet in your MCP configMCP_EMAIL_HTTP_ALLOWED_HOSTSSet in your MCP configMCP_EMAIL_DEFAULT_ACCOUNTSet in your MCP configMCP_EMAIL_TOOLSETSet in your MCP configInstall with your client
claude mcp add mailoo-email --env MCP_EMAIL_ADDRESS=<YOUR_MCP_EMAIL_ADDRESS> --env MCP_EMAIL_PASSWORD=<YOUR_MCP_EMAIL_PASSWORD> --env MCP_EMAIL_IMAP_HOST=<YOUR_MCP_EMAIL_IMAP_HOST> --env MCP_EMAIL_SMTP_HOST=<YOUR_MCP_EMAIL_SMTP_HOST> --env MCP_EMAIL_ACCOUNT_NAME=<YOUR_MCP_EMAIL_ACCOUNT_NAME> --env MCP_EMAIL_FULL_NAME=<YOUR_MCP_EMAIL_FULL_NAME> --env MCP_EMAIL_USERNAME=<YOUR_MCP_EMAIL_USERNAME> --env MCP_EMAIL_IMAP_PORT=<YOUR_MCP_EMAIL_IMAP_PORT> --env MCP_EMAIL_IMAP_TLS=<YOUR_MCP_EMAIL_IMAP_TLS> --env MCP_EMAIL_IMAP_STARTTLS=<YOUR_MCP_EMAIL_IMAP_STARTTLS> --env MCP_EMAIL_IMAP_VERIFY_SSL=<YOUR_MCP_EMAIL_IMAP_VERIFY_SSL> --env MCP_EMAIL_IMAP_DISABLE_IMAP4REV2=<YOUR_MCP_EMAIL_IMAP_DISABLE_IMAP4REV2> --env MCP_EMAIL_SIEVE_HOST=<YOUR_MCP_EMAIL_SIEVE_HOST> --env MCP_EMAIL_SIEVE_PORT=<YOUR_MCP_EMAIL_SIEVE_PORT> --env MCP_EMAIL_SMTP_PORT=<YOUR_MCP_EMAIL_SMTP_PORT> --env MCP_EMAIL_SMTP_TLS=<YOUR_MCP_EMAIL_SMTP_TLS> --env MCP_EMAIL_SMTP_STARTTLS=<YOUR_MCP_EMAIL_SMTP_STARTTLS> --env MCP_EMAIL_SMTP_VERIFY_SSL=<YOUR_MCP_EMAIL_SMTP_VERIFY_SSL> --env MCP_EMAIL_SMTP_POOL_ENABLED=<YOUR_MCP_EMAIL_SMTP_POOL_ENABLED> --env MCP_EMAIL_SMTP_POOL_MAX_CONNECTIONS=<YOUR_MCP_EMAIL_SMTP_POOL_MAX_CONNECTIONS> --env MCP_EMAIL_SMTP_POOL_MAX_MESSAGES=<YOUR_MCP_EMAIL_SMTP_POOL_MAX_MESSAGES> --env MCP_EMAIL_OAUTH2_PROVIDER=<YOUR_MCP_EMAIL_OAUTH2_PROVIDER> --env MCP_EMAIL_OAUTH2_CLIENT_ID=<YOUR_MCP_EMAIL_OAUTH2_CLIENT_ID> --env MCP_EMAIL_OAUTH2_CLIENT_SECRET=<YOUR_MCP_EMAIL_OAUTH2_CLIENT_SECRET> --env MCP_EMAIL_OAUTH2_REFRESH_TOKEN=<YOUR_MCP_EMAIL_OAUTH2_REFRESH_TOKEN> --env MCP_EMAIL_RATE_LIMIT=<YOUR_MCP_EMAIL_RATE_LIMIT> --env MCP_EMAIL_READ_ONLY=<YOUR_MCP_EMAIL_READ_ONLY> --env MCP_EMAIL_SAVE_TO_SENT=<YOUR_MCP_EMAIL_SAVE_TO_SENT> --env MCP_EMAIL_WATCHER_ENABLED=<YOUR_MCP_EMAIL_WATCHER_ENABLED> --env MCP_EMAIL_WATCHER_FOLDERS=<YOUR_MCP_EMAIL_WATCHER_FOLDERS> --env MCP_EMAIL_WATCHER_IDLE_TIMEOUT=<YOUR_MCP_EMAIL_WATCHER_IDLE_TIMEOUT> --env MCP_EMAIL_HOOK_ON_NEW_EMAIL=<YOUR_MCP_EMAIL_HOOK_ON_NEW_EMAIL> --env MCP_EMAIL_HOOK_PRESET=<YOUR_MCP_EMAIL_HOOK_PRESET> --env MCP_EMAIL_HOOK_AUTO_LABEL=<YOUR_MCP_EMAIL_HOOK_AUTO_LABEL> --env MCP_EMAIL_HOOK_AUTO_FLAG=<YOUR_MCP_EMAIL_HOOK_AUTO_FLAG> --env MCP_EMAIL_HOOK_BATCH_DELAY=<YOUR_MCP_EMAIL_HOOK_BATCH_DELAY> --env MCP_EMAIL_HOOK_CUSTOM_INSTRUCTIONS=<YOUR_MCP_EMAIL_HOOK_CUSTOM_INSTRUCTIONS> --env MCP_EMAIL_ALERT_DESKTOP=<YOUR_MCP_EMAIL_ALERT_DESKTOP> --env MCP_EMAIL_ALERT_SOUND=<YOUR_MCP_EMAIL_ALERT_SOUND> --env MCP_EMAIL_ALERT_URGENCY_THRESHOLD=<YOUR_MCP_EMAIL_ALERT_URGENCY_THRESHOLD> --env MCP_EMAIL_ALERT_WEBHOOK_URL=<YOUR_MCP_EMAIL_ALERT_WEBHOOK_URL> --env MCP_EMAIL_ALERT_WEBHOOK_ALLOW_PRIVATE=<YOUR_MCP_EMAIL_ALERT_WEBHOOK_ALLOW_PRIVATE> --env MCP_EMAIL_HOOK_AUTO_CALENDAR=<YOUR_MCP_EMAIL_HOOK_AUTO_CALENDAR> --env MCP_EMAIL_HOOK_CALENDAR_NAME=<YOUR_MCP_EMAIL_HOOK_CALENDAR_NAME> --env MCP_EMAIL_HOOK_CALENDAR_ALARM_MINUTES=<YOUR_MCP_EMAIL_HOOK_CALENDAR_ALARM_MINUTES> --env MCP_EMAIL_HOOK_CALENDAR_CONFIRM=<YOUR_MCP_EMAIL_HOOK_CALENDAR_CONFIRM> --env MCP_EMAIL_SYSTEM_ONE_ENABLED=<YOUR_MCP_EMAIL_SYSTEM_ONE_ENABLED> --env MCP_EMAIL_HTTP_HOST=<YOUR_MCP_EMAIL_HTTP_HOST> --env MCP_EMAIL_HTTP_TOKEN=<YOUR_MCP_EMAIL_HTTP_TOKEN> --env MCP_EMAIL_HTTP_ALLOWED_HOSTS=<YOUR_MCP_EMAIL_HTTP_ALLOWED_HOSTS> --env MCP_EMAIL_DEFAULT_ACCOUNT=<YOUR_MCP_EMAIL_DEFAULT_ACCOUNT> --env MCP_EMAIL_TOOLSET=<YOUR_MCP_EMAIL_TOOLSET> -- npx -y @bitfloo/mailoo@0.3.5
Run this in a terminal to add the server to Claude Code.
What this does
Mailoo - Email MCP Server exposes a set of tools to Claude over the Model Context Protocol. After you add it to claude_desktop_config.json (snippet above) and restart Claude Desktop, those tools become callable inside any conversation.
Requirements
This server needs the following environment variables to be set before it can run:
MCP_EMAIL_ADDRESS 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 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 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 MCP_EMAIL_HTTP_ALLOWED_HOSTS MCP_EMAIL_DEFAULT_ACCOUNT MCP_EMAIL_TOOLSET
Set these via the env object in your MCP config (see claude_desktop_config.json snippet above).
Frequently asked questions
How do I install Mailoo - Email MCP Server?
Run the Claude Code command in the install section to add Mailoo - Email MCP Server to Claude Code, or copy the ready-made config for your client from the install section on this page. Restart your client afterwards and the tools appear in your next conversation.
Which clients work with Mailoo - Email MCP Server?
This page carries setup and config for Claude Code, Claude Desktop, Cursor and VS Code. Any other MCP client that accepts a standard server config can connect to Mailoo - Email MCP Server as well.
Does Mailoo - Email MCP Server need an API key?
Yes. Before it can run, set these environment variables: MCP_EMAIL_ADDRESS, 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, 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, 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, MCP_EMAIL_HTTP_ALLOWED_HOSTS, MCP_EMAIL_DEFAULT_ACCOUNT, MCP_EMAIL_TOOLSET. They go in the env block of your MCP config.
Imported from the Official MCP Registry. The details above come from the registry entry; the maker can claim this listing to correct them, add docs, and see its traffic.
Is this your MCP server?
Claim this listing to see its traffic, fix details yourself, and skip the review queue on future updates.
Add this badge to your README
Show visitors this server is listed in the ClaudeRules directory. The badge links straight to this listing.
[](https://clauderules.net/mcp/io-github-bitfloo-mailoo)<a href="https://clauderules.net/mcp/io-github-bitfloo-mailoo" target="_blank" rel="noopener noreferrer"><img src="https://clauderules.net/api/badge/io-github-bitfloo-mailoo" alt="Listed on clauderules.net" /></a>More AI MCP servers
Awesome MCP Servers by punkpeye
A curated, community-maintained list of Model Context Protocol (MCP) servers, organized by category, with sections for MCP clients, tutorials, and community resources. The repository is a directory of production-ready and experimental servers that extend AI capabilities through file access, database connections, and API integrations; it is a list, not a runnable MCP server itself.
GitHub
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
FastMCP
🐍 - A high-level framework for building MCP servers in Python
Serena MCP: the IDE for your agent
A powerful toolkit for coding, providing semantic retrieval and editing capabilities.