Mailoo - Email MCP Server

What does Mailoo - Email MCP Server need from you?

API key — Password or app password. Required unless MCP_EMAIL_OAUTH2_PROVIDER is set.

• MCP_EMAIL_ADDRESSrequiredEnvironment variable

  Email address. Required for the environment-variable account.

• MCP_EMAIL_PASSWORDoptionalsecretEnvironment variable

  Password or app password. Required unless MCP_EMAIL_OAUTH2_PROVIDER is set.

• MCP_EMAIL_IMAP_HOSTrequiredEnvironment variable

  IMAP server hostname.

• MCP_EMAIL_SMTP_HOSTrequiredEnvironment variable

  SMTP server hostname.

• MCP_EMAIL_ACCOUNT_NAMEoptionalEnvironment variable

  Account name. Defaults to default.

• MCP_EMAIL_FULL_NAMEoptionalEnvironment variable

  Display name on sent mail.

• MCP_EMAIL_USERNAMEoptionalEnvironment variable

  Login username. Defaults to the email address.

• MCP_EMAIL_IMAP_PORToptionalEnvironment variable

  IMAP port. Defaults to 993.

• MCP_EMAIL_IMAP_TLSoptionalEnvironment variable

  Set to false to turn off implicit IMAP TLS. Defaults to true.

• MCP_EMAIL_IMAP_STARTTLSoptionalEnvironment variable

  Set to true to upgrade IMAP with STARTTLS. Defaults to false.

• MCP_EMAIL_IMAP_VERIFY_SSLoptionalEnvironment variable

  Set to false to skip IMAP certificate verification. Defaults to true.

• MCP_EMAIL_IMAP_DISABLE_IMAP4REV2optionalEnvironment variable

  Set to true to force IMAP4rev1 SEARCH.

• MCP_EMAIL_SIEVE_HOSToptionalEnvironment variable

  ManageSieve hostname. Defaults to the IMAP host.

• MCP_EMAIL_SIEVE_PORToptionalEnvironment variable

  ManageSieve port. Defaults to 4190.

• MCP_EMAIL_SMTP_PORToptionalEnvironment variable

  SMTP port. Defaults to 465.

• MCP_EMAIL_SMTP_TLSoptionalEnvironment variable

  Set to false to turn off implicit SMTP TLS. Defaults to true.

• MCP_EMAIL_SMTP_STARTTLSoptionalEnvironment variable

  Set to true to upgrade SMTP with STARTTLS. Defaults to false.

• MCP_EMAIL_SMTP_VERIFY_SSLoptionalEnvironment variable

  Set to false to skip SMTP certificate verification. Defaults to true.

• MCP_EMAIL_SMTP_POOL_ENABLEDoptionalEnvironment variable

  Set to false to disable SMTP connection pooling. Defaults to true.

• MCP_EMAIL_SMTP_POOL_MAX_CONNECTIONSoptionalEnvironment variable

  Maximum pooled SMTP connections. Defaults to 1.

• MCP_EMAIL_SMTP_POOL_MAX_MESSAGESoptionalEnvironment variable

  Maximum messages per pooled SMTP connection. Defaults to 100.

• MCP_EMAIL_OAUTH2_PROVIDERoptionalEnvironment variable

  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_IDoptionalEnvironment variable

  OAuth2 client id.

• MCP_EMAIL_OAUTH2_CLIENT_SECREToptionalsecretEnvironment variable

  OAuth2 client secret.

Pass secrets through your shell environment rather than committing them into a config file.

What tools does Mailoo - Email MCP Server expose? (66)

Taken from the project's README — the server itself was not queried, so check its docs for the exact schemas.

• osascriptmacOS notifications, calendar events, reminders
• notify-sendLinux desktop notifications
• paplayLinux notification sound
• powershellWindows balloon notifications
• whichChecks that `osascript`, `afplay`, `notify-send`, `paplay`, or `powershell` exists. `afplay` is only probed; macOS sound goes through `osascript`
• xdg-openOpens a temporary calendar file on Linux
• launchctlInstalls, removes or checks (`scheduler status`) the macOS scheduler agent
• crontabInstalls, removes or checks (`scheduler status`) the Linux scheduler line
• savePath`download_attachment` or `export_email` when that argument is set
• list_accountsList all configured email accounts
• list_mailboxesList folders with unread counts and special-use flags
• list_emailsPaginated email listing with date, sender, subject, and flag filters
• get_emailRead full email content with attachment metadata
• get_emailsFetch full content of multiple emails in a single call (max 20)
• get_email_statusGet read/flag/label state of an email without fetching the body
• search_emailsSearch by keyword; `since`/`before` (aliases `start_date`/`end_date`)
• download_attachmentDownload an attachment (base64, or `savePath` to disk — not a read-only write)
• export_emailExport one message as its raw RFC 822 `.eml` source (base64, or `savePath` to disk); flags unchanged
• find_email_folderDiscover the real folder(s) an email resides in (resolves virtual folders)
• extract_contactsExtract unique contacts from recent email headers
• get_threadReconstruct a conversation thread via References/In-Reply-To
• list_templatesList available email templates
• get_email_statsEmail analytics — volume, top senders, daily trends
• check_healthConnection health, latency, quota, and IMAP capabilities
• get_email_securityRead-only SPF/DKIM/DMARC and From/Reply-To/Return-Path domains
• sieve_statusWhether ManageSieve is reachable (default port 4190)
• sieve_list_scriptsList ManageSieve scripts
• sieve_get_scriptDownload a ManageSieve script
• send_emailSend a new email (plain text or HTML, CC/BCC, attachments)
• reply_emailReply with proper threading (In-Reply-To, References)
• forward_emailForward with original content quoted
• save_draftSave a draft (RFC 2047 subjects; optional attachments)
• send_draftSend an existing draft and remove from Drafts
• apply_templateApply a template with variable substitution
• schedule_emailSchedule an email for future delivery
• list_scheduledList scheduled emails by status
• cancel_scheduledCancel a pending scheduled email
• sieve_put_scriptCreate or replace a ManageSieve script (does not activate)
• sieve_delete_scriptDelete a ManageSieve script
• sieve_activate_scriptActivate a script (empty name deactivates all)
• move_emailMove email between folders
• delete_emailMove to Trash or permanently delete
• mark_emailMark as read/unread, flag/unflag
• bulk_actionBatch operation on up to 100 emails
• create_mailboxCreate a new mailbox folder
• rename_mailboxRename an existing mailbox folder (not INBOX or a special-use folder)
• delete_mailboxPermanently delete a mailbox and contents (not INBOX or a special-use folder)
• list_labelsDiscover available labels (auto-detects provider strategy)
• add_labelAdd a label to an email (ProtonMail folders, Gmail X-GM-LABELS, or IMAP keywords)
• remove_labelRemove a label from an email
• create_labelCreate a new label
• delete_labelDelete a label (on Gmail, not INBOX or a special-use folder)
• get_watcher_statusShow IMAP IDLE connections, folders being monitored, and last-seen UIDs
• list_presetsList available AI triage presets with descriptions and suggested labels
• get_hooks_configShow current hooks configuration — preset, rules, and custom instructions
• configure_alertsUpdate alert/notification settings at runtime
• check_notification_setupDiagnose desktop notification support and provide setup instructions
• test_notificationSend a test notification to verify OS permissions are configured
• extract_calendarExtract ICS/iCalendar events from an email
• analyze_email_for_schedulingAnalyze an email to detect events and reminder-worthy content
• add_to_calendarAdd an email event to the local calendar (macOS/Linux)
• create_reminderCreate a reminder in macOS Reminders.app from an email
• list_calendarsList all available local calendars
• list_eventsList local calendar events with optional title, date, and calendar filters
• list_remindersList Reminders.app items with optional title and list filters
• check_calendar_permissionsCheck whether the local calendar is accessible

What the code can do

Read from the published package source — never executed. Parsed 80 of 122 source files.

This server can run other programs on your machine, read and write files and make network requests.

• Runs other programsImports Node's child_process module, which starts other programs on your machine with your user's permissions.
• Reads and writes filesImports Node's fs module. Nothing in the package limits this to a particular folder — scoping is whatever you configure when you launch it.
• Makes network requestsOpens network connections or calls fetch, so data it handles can leave your machine and it can pull data in.
• Reads environment variablesReads process.env. That is how it picks up the API keys you configure — and it is not restricted to only those variables.
• Reads system informationImports os or v8 to read machine details such as hostname, platform or home directory.

Before you install

Signals gathered from the source repo and package registry — not a safety verdict.

• Last commit today — Actively maintained.
• Repository created 1 month ago — Very new project with little track record yet.
• 0 GitHub stars — Very little community usage so far.

Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated

• Maintenance30%100%

  Last commit 0 days ago.

• Adoption20%0%

  0 stars.

• Transparency20%100%

  4/4: ✓ public source repo, ✓ declared license, ✓ documentation, ✓ discoverable tool list.

• Provenance15%100%

  Package and registry entry point at the same repository.

• Packaging15%100%

  Publishes a pinned version (0.3.1).

Excerpt — the full document is on GitHub.

Maintain Mailoo - Email MCP Server? Add a badge to your README

Shows its health grade, and links readers to install steps for every client.

[![Mailoo - Email MCP Server on MCP Skills Hub](https://mcp-skills-hub.vercel.app/badge/io-github-bitfloo-mailoo)](https://mcp-skills-hub.vercel.app/mcps/io-github-bitfloo-mailoo)