# Agentic-Assets/apple-mail-mcp

Source: https://glimind.com/server/github%2Fagentic-assets%2Fapple-mail-mcp
Registry id: `github/agentic-assets/apple-mail-mcp`
Status: unknown

## Tools (41)

- `batch_create_events`: Up to 25 one-off events on one calendar; all validate before write
- `check_availability`: Busy blocks and free slots inside working hours (max 62 days)
- `compose_email`: Create a new standalone draft by default
- `create_event`: Timezone-correct event creation with conflict detection
- `create_mailbox`: Create new mailboxes (supports nested paths)
- `create_rich_email_draft`: Build a standalone multipart HTML .eml with optional attachments
- `delete_events`: Exact-id bulk delete, dry-run default, capped and chunked
- `export_emails`: Export TXT, HTML, or raw RFC 822 EML by exact message_ids
- `forward_email`: Forward by message_id (required)
- `full_inbox_export`: Disabled: returns UNBOUNDED_EXPORT_DISABLED error
- `get_awaiting_reply`: Sent emails that haven't received a reply (default last 7 days)
- `get_email_by_id`: Fetch one exact email by Apple Mail message id
- `get_email_by_ids`: Fetch multiple exact emails by reviewed Apple Mail message ids
- `get_email_thread`: Conversation thread view across Inbox + Sent
- `get_events_by_id`: Full detail for exact event ids; always window-bounded
- `get_inbox_overview`: Dashboard with unread counts, folders, and recent emails
- `get_mailbox_unread_counts`: Unread counts per mailbox or per-account summary
- `get_needs_response`: Unread emails likely needing a response
- `get_statistics`: Account overview, sender stats, or mailbox breakdown
- `get_top_senders`: Most frequent senders by count or domain over a date window
- `inbox_dashboard`: Interactive UI dashboard (requires mcp-ui-server)
- `list_account_addresses`: List sender aliases configured for a Mail account
- `list_accounts`: List all configured Mail accounts
- `list_calendars`: List every calendar with id, writability, defaults, and diagnostics
- `list_email_attachments`: List attachments by message_ids (required)
- `list_events`: Bounded event listing/search with filters and paging
- `list_inbox_emails`: List emails (defaults to 50 most recent)
- `list_mailboxes`: Folder hierarchy with optional message counts
- `manage_calendars`: Create/rename/delete calendars; delete is triple-gated
- `manage_drafts`: Create, list, send, open, and delete drafts
- `manage_trash`: Soft delete, permanent delete, empty trash
- `move_email`: Move by message_ids (required for targeting)
- `reply_to_email`: Native Mail reply or reply-all draft
- `respond_to_invitation`: Documented refusal: no public macOS API can RSVP
- `save_email_attachment`: Save a specific attachment to disk
- `search_emails`: Unified search: subject, sender, body, dates, attachments
- `synchronize_account`: Explicitly confirmed Mail.app sync for an account
- `update_email_status`: Mark read/unread, flag/unflag by message_ids
- `update_event`: ID-first PATCH update; recurring targets require span
- `verify_draft`: Verify one exact Drafts message id; returns JSON snapshot
- `verify_drafts`: Verify multiple exact Drafts message ids and merge snapshots

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
