Communication · OS Automation

Apple Mail MCP logo

Apple Mail MCP

patrickfreyer/apple-mail-mcp

An MCP server that gives AI assistants full access to Apple Mail -- read, search, compose, organize, and analyze emails via natural language. Built with FastMCP.

Install

uvx mcp-apple-mail

Client configuration

{
  "mcpServers": {
    "apple-mail": {
      "command": "uvx",
      "args": [
        "mcp-apple-mail"
      ]
    }
  }
}

Environment variables

USER_EMAIL_PREFERENCES
Category
Communication, OS Automation
License
MIT
Updated
Oct 6, 2026

Tools (24)

  • get_inbox_overview

    Dashboard with unread counts, folders, and recent emails

  • list_inbox_emails

    List emails with account/read-status filtering and optional content preview

  • get_mailbox_unread_counts

    Unread counts per mailbox or per-account summary

  • list_accounts

    List all configured Mail accounts

  • search_emails

    Unified search — subject, sender, body text, dates, attachments, flag status/color, cross-account

  • get_email_thread

    Conversation thread view

  • list_mailboxes

    Folder hierarchy with message counts

  • create_mailbox

    Create new mailboxes (supports nested paths)

  • move_email

    Move/archive emails with filters (subject, sender, date, read status, dry-run)

  • update_email_status

    Mark read/unread, flag/unflag (optional flag color) — by filters or message IDs

  • manage_trash

    Soft delete, permanent delete, empty trash (with dry-run)

  • compose_email

    Send new emails (plain text or HTML body)

  • reply_to_email

    Reply or reply-all with optional HTML body

  • forward_email

    Forward with optional message, CC/BCC

  • manage_drafts

    Create, list, send, and delete drafts

  • create_rich_email_draft

    Build a rich HTML.eml draft, open it in Mail, and optionally save it to Drafts

  • list_email_attachments

    List attachments with names and sizes

  • save_email_attachment

    Save attachments to disk

  • get_awaiting_reply

    Find sent emails that haven't received a reply

  • get_needs_response

    Identify emails that likely need your response

  • get_top_senders

    Analyse most frequent senders by count or domain

  • get_statistics

    Email analytics (volume, top senders, read ratios)

  • export_emails

    Export single emails or mailboxes to TXT/HTML

  • inbox_dashboard

    Interactive UI dashboard (requires mcp-ui-server)

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS

Related MCP servers

More servers
Inbox Zero AI MCP logo

Inbox Zero AI MCP

elie222/inbox-zero

7.1k

To help you spend less time in your inbox, so you can focus on what matters most.

Communication
whatsapp logo

whatsapp

lharries/whatsapp-mcp

3.6k

This is a Model Context Protocol (MCP) server for WhatsApp.

Communication
Apple MCP Server logo

Apple MCP Server

Dhravya/apple-mcp

1.5k

Apple MCP toolset is a collection of Apple native tools based on the MCP protocol, providing integration services for Messages, Notes, Contacts, Mail, Reminders, Calendar and other Apple ecosystem features.

Communication
supergateway logo

supergateway

supercorp-ai/supergateway

1.1k

Supergateway runs MCP stdio-based servers over SSE (Server-Sent Events) or WebSockets (WS) with one command. This is useful for remote access, debugging, or connecting to clients when your MCP server only supports stdio.

Communication
Line Bot MCP Server logo

Line Bot MCP Server

line/line-bot-mcp-server

338

Model Context Protocol (MCP) server implementation that integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account.

Communication
MCP Send Email logo

MCP Send Email

resend/mcp-send-email

325

Connect your AI agent to the Resend platform. Send and receive emails, manage contacts, broadcasts, domains, and more, directly from any MCP client like Claude, Cursor, or Claude Code.

Communication