{"id":"patrickfreyer-apple-mail-mcp","name":"apple-mail-mcp","homepage":null,"repo_url":"https://github.com/patrickfreyer/apple-mail-mcp","category":"communication","subcategories":[],"tags":["mcp","apple-mail","macos","email-automation","fastmcp","automation","assistant-tools"],"what_it_does":"Provides an MCP server on macOS that lets AI assistants access Apple Mail via natural-language tools: read/search emails, manage folders and message state, compose/reply/forward, handle drafts and attachments, and generate basic analytics/export.","use_cases":["Inbox triage and quick summaries for an Apple Mail mailbox","Natural-language email search and thread exploration","Assist composing replies/forwards and managing drafts","Organize messages (move/archive, mark read/unread, flag) using filters","Light analytics/export of mail content"],"not_for":["Server-side or cross-platform email automation (macOS + Mail.app required)","Highly regulated environments where automation permissions and local mail access are not acceptable","Public web/API use by untrusted clients (this is an on-device MCP tool, not a remote service)"],"best_when":"You want a local, macOS-based assistant to automate Apple Mail workflows through an MCP-compatible client (e.g., Claude Desktop/Code).","avoid_when":"You need a remote, multi-tenant email API, or you cannot grant Mail.app Automation + Mail Data Access permissions.","alternatives":["Use an IMAP/SMTP-based integration (e.g., via an email provider API) instead of Apple Mail automation","Build a local assistant using AppleScript/GUI scripting directly (more brittle than MCP tool contracts)","Use Gmail/Exchange APIs if your mailbox is not Apple Mail local data"],"af_score":60.5,"security_score":61.8,"reliability_score":35.0,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:52:10.374756+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Local client-based MCP session (no network auth described)"],"oauth":false,"scopes":false,"notes":"The security model is primarily macOS permission-gated: user must grant Mail.app Automation + Mail Data Access in System Settings. No OAuth/API-key model is described."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Open-source (MIT). Costs are local (compute + macOS usage) and any MCP client usage; no hosted pricing indicated."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":["macOS device-local Mail.app data (implied)"],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":60.5,"security_score":61.8,"reliability_score":35.0,"mcp_server_quality":86.0,"documentation_accuracy":78.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":35.0,"rate_limit_clarity":20.0,"tls_enforcement":90.0,"auth_strength":45.0,"scope_granularity":35.0,"dependency_hygiene":70.0,"secret_handling":75.0,"security_notes":"Tool access is local to the user’s macOS instance, and security relies on macOS privacy/automation permissions rather than programmatic OAuth/API keys. The README mentions a read-only mode to reduce risk for send actions, and conservative batch limits for side-effecting operations. No detailed guidance is provided on least-privilege scopes within the MCP server, data redaction, logging behavior, or structured error codes. Secrets are not described (likely none required), but the server likely has access to email content and attachments as part of its function.","uptime_documented":0.0,"version_stability":55.0,"breaking_changes_history":40.0,"error_recovery":45.0,"idempotency_support":"false","idempotency_notes":"Not documented. Several tools perform side effects (move, delete, send/reply/forward) with conservative default batch limits, but explicit idempotency guarantees are not stated.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["macOS Automation + Mail Data Access permissions must be granted; otherwise tool calls fail (permission errors).","Mailbox/folder names must match exactly; nested paths use '/' separators.","Bulk operations have conservative defaults (e.g., move_email default limit 1, manage_trash default limit 5, update_email_status default limit 10).","For rich HTML, use create_rich_email_draft rather than injecting raw HTML content elsewhere to avoid literal markup issues."]}}