Skip to content
Agentmart
Submit a tool

Apple Mail

Read, search, compose, and send emails via Apple Mail on macOS.

Connector by JonathanRReed · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 28
Write a review

Install

Works with Claude Code, Codex, VS Code, Claude Desktop, Cursor, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install connector/jonathanrreed-apple-mcp-mail

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Read, search, compose, and send emails via Apple Mail on macOS.

Use cases: email

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
9 read · 8 write · 1 delete
Secrets
None asked for
Install scripts
None found
Runs as
Python package

Tools by what they do 18

Read from the source code; the running server may list different tools.

Read 9 · Look things up without changing anything.

  • mail_get_message
  • mail_get_prompt
  • mail_get_thread
  • mail_health
  • mail_list_mailboxes
  • mail_list_prompts
  • mail_permission_guide
  • mail_recheck_permissions
  • mail_search_messages

Write 8 · Create, change, send or run things.

  • mail_archive_thread
  • mail_compose_draft
  • mail_forward_message
  • mail_mark_message
  • mail_move_message
  • mail_reply_latest_in_thread
  • mail_reply_message
  • mail_send_message

Delete 1 · Delete, drop, revoke or wipe things.

  • mail_delete_message

Secrets and settings it asks for

Other settings (environment variables or headers).

  • APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT
  • APPLE_MAIL_MCP_SAFETY_PROFILE
  • APPLE_MAIL_MCP_VISIBLE_DRAFTS

Network hosts it talks to 3

  • docs.astral.sh · found in code
  • github.com · found in install command, code
  • raw.githubusercontent.com · found in code

Tools (18)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • mail_archive_threadArchive Thread

    Move related messages in the same mailbox thread to the target archive mailbox.

  • mail_compose_draftCompose Draft

    Create a draft message in Apple Mail without sending it. Optionally specify from_account as an email address or account name to set the sender.

  • mail_delete_messageDelete Message

    Delete (trash) an email message by its message_id.

  • mail_forward_messageForward Message

    Forward an existing email message to new recipients. Provide a message_id and the to list. Optionally prepend body text and specify from_account. In full_access the forward is sent; in safe_manage it is saved as an unsent draft in Mail for the user to review (check `sent` and `note` in the result).

  • mail_get_messageGet Email

    Fetch a single Apple Mail message by message_id.

  • mail_get_promptMail Get Prompt

    Fallback prompt rendering tool for tool-only MCP clients.

  • mail_get_threadGet Thread

    Find related messages in the same mailbox thread by normalized subject, anchored on a message_id.

  • mail_healthMail Health

    Report the active Apple Mail MCP configuration.

  • mail_list_mailboxesList Mailboxes

    List Apple Mail mailboxes, optionally filtered by account.

  • mail_list_promptsMail List Prompts

    Fallback prompt discovery tool for tool-only MCP clients.

  • mail_mark_messageMark Message Read/Unread

    Set the read status of an email message. Pass is_read=true to mark as read, is_read=false to mark as unread.

  • mail_move_messageMove Message

    Move an email message to a different mailbox. Optionally specify target_account if the mailbox is in a different account.

  • mail_permission_guideMail Permission Guide

    Explain how to grant Apple Mail automation permission on macOS.

  • mail_recheck_permissionsMail Recheck Permissions

    Recheck Mail access after the user changes macOS permissions, and notify the client that Mail resources changed.

  • mail_reply_latest_in_threadReply To Latest In Thread

    Find the latest related message in the same mailbox thread and reply to that message.

Show 3 more tools
  • mail_reply_messageReply to Message

    Reply to an existing email message. Provide a message_id and body text. Set reply_all=true to reply to all recipients. Optionally specify from_account.

  • mail_search_messagesSearch Mail

    Search Apple Mail messages by query with optional account, mailbox and unread filters. Without account, accounts are searched in Mail's order and the limit can be filled by the first one; pass account (as returned by mail_list_mailboxes) to search a specific account.

  • mail_send_messageSend Email

    Send an email immediately via Apple Mail. Optionally specify from_account as an email address or account name to set the sender.

Compare and alternatives

    Featured in

    Signals

    Stars
    28
    Forks
    4
    Open issues
    0
    Contributors
    6
    Weekly downloads
    404
    Last commit (this folder)
    Oct 22, 2026 (7 days ago)
    Last release
    Oct 22, 2026 (6 days ago)
    Last package publish
    Oct 22, 2026 (6 days ago)

    From GitHub (fetched Oct 24, 2026) and the package registry.

    Details

    Registry name
    io.github.JonathanRReed/apple-mcp-mail
    Version
    1.1.3
    Auth
    No auth
    Packages
    pypi apple-mcp-mailmcpb https://github.com/JonathanRReed/Apple-MCPs/releases/download/v1.1.3/apple-mail-1.1.3.mcpb
    License
    MIT
    Repository
    github.com/JonathanRReed/Apple-MCPs
    Website
    github.com/JonathanRReed/Apple-MCPs
    First seen
    Oct 24, 2026
    Last checked
    Oct 24, 2026
    Source
    Official MCP Registrygithub-graphql

    More from JonathanRReed

    Cite this page

    Apple Mail MCP server. Agent Mart. https://agentmart.dev/connectors/jonathanrreed-apple-mcp-mail (last updated 2026-10-24)