Skip to content
Agentmart
Submit a tool

Apple Tools (Unified)

Unified Apple ecosystem MCP server for macOS: Mail, Calendar, Notes, Files, Messages, and more.

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-tools-mcp

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

Unified Apple ecosystem MCP server for macOS: Mail, Calendar, Notes, Files, Messages, and more.

Use cases: email, scheduling, note-taking, file-management, team-chat

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
40 read · 19 write · 3 delete · 2 not yet classified
Secrets
None asked for
Install scripts
None found
Runs as
Python package

Tools by what they do 64

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

Read 40 · Look things up without changing anything.

  • apple_capture_follow_up_from_mail
  • apple_detect_defaults
  • apple_detect_digest_folder
  • apple_event_collaboration_summary
  • apple_find_duplicate_contacts
  • apple_generate_daily_briefing
  • apple_generate_weekly_briefing
  • apple_get_focus_status
  • apple_get_preferences
  • apple_get_prompt
  • apple_get_system_context
  • apple_health
Show 28 more tools
  • apple_list_prompts
  • apple_list_recent_actions
  • apple_list_shortcuts_for_capability
  • apple_maps_get_directions_strict
  • apple_maps_search_places_strict
  • apple_overview
  • apple_permission_guide
  • apple_prepare_communication
  • apple_prepare_unique_contact
  • apple_preview_archive_message
  • apple_preview_communication
  • apple_preview_create_note_with_defaults
  • apple_preview_create_reminder_with_defaults
  • apple_preview_follow_up_from_mail
  • apple_recheck_permissions
  • apple_triage_communications_task
  • test_audio_content
  • test_embedded_resource
  • test_image_content
  • test_input_required_result_capabilities
  • test_input_required_result_elicitation
  • test_input_required_result_list_roots
  • test_input_required_result_multi_round
  • test_input_required_result_multiple_inputs
  • test_input_required_result_request_state
  • test_input_required_result_sampling
  • test_input_required_result_tampered_state
  • test_missing_capability

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

  • apple_archive_message
  • apple_create_event_interactive
  • apple_create_note_with_defaults
  • apple_create_reminder_with_defaults
  • apple_ensure_digest_folder
  • apple_open_application
  • apple_open_file_path
  • apple_reveal_in_finder
  • apple_route_or_run_shortcut
  • apple_send_communication
  • apple_send_message_interactive
  • apple_set_digest_folder
Show 7 more tools
  • apple_update_contact_preferences
  • apple_update_preferences
  • apple_update_system_setting
  • test_multiple_content_types
  • test_tool_with_progress
  • test_trigger_prompt_change
  • test_trigger_tool_change

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

  • apple_control_frontmost_app
  • apple_tag_file
  • apple_undo_action

Not yet classified 2 · We could not tell from the name and description.

  • test_dynamic_prompt
  • test_dynamic_tool

Secrets and settings it asks for

Other settings (environment variables or headers).

  • APPLE_CALENDAR_MCP_SAFETY_MODE
  • APPLE_CONTACTS_MCP_SAFETY_MODE
  • APPLE_FILES_MCP_ALLOWED_ROOTS
  • APPLE_FILES_MCP_SAFETY_MODE
  • APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT
  • APPLE_MAIL_MCP_SAFETY_PROFILE
  • APPLE_MESSAGES_MCP_SAFETY_MODE
  • APPLE_NOTES_MCP_SAFETY_MODE
  • APPLE_REMINDERS_MCP_SAFETY_MODE
  • APPLE_SHORTCUTS_MCP_SAFETY_MODE
  • APPLE_SYSTEM_MCP_GUI_ALLOWED_APPS
  • APPLE_SYSTEM_MCP_SAFETY_MODE

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

Files it touches

  • Your home directory (~)
  • ~/.apple-tools-mcp/preferences.json
  • Any path the agent passes to its tools

Tools (64)

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

  • apple_archive_messageApple Archive Message

    Move a message to the preferred archive mailbox, or auto-detect an archive mailbox if no preference exists yet.

  • apple_capture_follow_up_from_mailApple Capture Follow-Up From Mail

    Turn an email into a reminder and an archival note using assistant defaults for the destination list and notes folder.

  • apple_control_frontmost_appApple Control Frontmost App

    Use the unified Apple control plane for bounded GUI fallback actions when a native app-domain tool cannot complete the task. Input actions (click_menu_path, press_keys, type_text, click_button, choose_popup_value) require application or bundle_id naming a running app whose bundle id is listed in APPLE_SYSTEM_MCP_GUI_ALLOWED_APPS (comma-separated bundle ids; GUI input is off while it is empty), and that app must come to the front before any input is sent. Terminals, script editors and automation apps are always refused, even if allow-listed.

  • apple_create_event_interactiveApple Create Event Interactive

    Create a Calendar event, asking for missing event details when needed.

  • apple_create_note_with_defaultsApple Create Note With Defaults

    Create a note using the configured default notes folder when folder_id is omitted.

  • apple_create_reminder_with_defaultsApple Create Reminder With Defaults

    Create a reminder using the configured default reminder list when list_id is omitted.

  • apple_detect_defaultsApple Detect Defaults

    Read saved defaults without probing apps. Set probe_apps=true to discover and persist missing Mail, Calendar, Reminders, and Notes targets; this may open apps and request macOS permissions.

  • apple_detect_digest_folderApple Detect Digest Folder

    Detect the preferred Notes folder for daily and weekly digests, and persist it if found.

  • apple_ensure_digest_folderApple Ensure Digest Folder

    Ensure a dedicated Notes folder exists for daily and weekly digests, creating it when necessary and persisting the preference.

  • apple_event_collaboration_summaryApple Event Collaboration Summary

    Summarize attendee state for a shared calendar event so agents can verify collaboration and participation.

  • apple_find_duplicate_contactsApple Find Duplicate Contacts

    Find likely duplicate contacts through Apple Contacts so assistants can disambiguate people before acting.

  • apple_generate_daily_briefingApple Generate Daily Briefing

    Generate a daily Apple briefing from today's context, domain health, and Mail highlights.

  • apple_generate_weekly_briefingApple Generate Weekly Briefing

    Generate a weekly Apple briefing from upcoming events, reminders, and Mail highlights.

  • apple_get_focus_statusApple Get Focus Status

    Return truthful Focus support metadata through the unified Apple control plane.

  • apple_get_preferencesApple Get Preferences

    Read the persisted Apple-Tools assistant defaults and routing preferences.

Show 49 more tools
  • apple_get_promptApple Get Prompt

    Fallback prompt rendering tool for clients that only support tools.

  • apple_get_system_contextApple Get System Context

    Return a richer Apple system context snapshot, including Focus, frontmost app, and battery state.

  • apple_healthApple Health

    Report aggregated health across the unified Apple ecosystem MCP domains.

  • apple_list_promptsApple List Prompts

    Fallback prompt discovery tool for clients that only support tools.

  • apple_list_recent_actionsApple List Recent Actions

    List recent assistant actions recorded by Apple-Tools for audit and undo workflows.

  • apple_list_shortcuts_for_capabilityApple List Shortcuts For Capability

    List likely shortcuts for a requested capability so Apple-Tools can use Shortcuts as an intentional bridge when native coverage is missing.

  • apple_maps_get_directions_strictApple Maps Get Directions Strict

    Get directions through the native Apple Maps MCP and fail closed if the Maps helper is unavailable.

  • apple_maps_search_places_strictApple Maps Search Places Strict

    Search places through the native Apple Maps MCP and fail closed if the Maps helper is unavailable.

  • apple_open_applicationApple Open Application

    Open an application through the unified Apple control plane using its name or bundle identifier.

  • apple_open_file_pathApple Open File Path

    Open a file or folder through Apple Files and return iCloud-aware path metadata.

  • apple_overviewApple Overview

    Return domain health and saved preferences; defer permission-sensitive data reads and Shortcuts library enumeration.

  • apple_permission_guideApple Permission Guide

    Explain how to grant the Apple permissions needed by a given Apple domain on macOS.

  • apple_prepare_communicationApple Prepare Communication

    Resolve a recipient through Contacts, evaluate available channels, and return the recommended mail or messages target before sending.

  • apple_prepare_unique_contactApple Prepare Unique Contact

    Resolve a contact for a person-targeted workflow, but stop and return duplicate groups if likely duplicate records need cleanup first.

  • apple_preview_archive_messageApple Preview Archive Message

    Preview how Apple-Tools will archive a Mail message before moving it.

  • apple_preview_communicationApple Preview Communication

    Preview how Apple-Tools will route a communication before sending it through Messages or Mail.

  • apple_preview_create_note_with_defaultsApple Preview Create Note With Defaults

    Preview how Apple-Tools will create a note with the configured default notes folder.

  • apple_preview_create_reminder_with_defaultsApple Preview Create Reminder With Defaults

    Preview how Apple-Tools will create a reminder with the configured default reminder list.

  • apple_preview_follow_up_from_mailApple Preview Follow-Up From Mail

    Preview how Apple-Tools will turn an email into a reminder and note before creating either item.

  • apple_recheck_permissionsApple Recheck Permissions

    Recheck Apple domain health after the user changes macOS permissions, and notify the client that Apple resources changed.

  • apple_reveal_in_finderApple Reveal In Finder

    Reveal a file or folder in Finder through Apple Files.

  • apple_route_or_run_shortcutApple Route Or Run Shortcut

    Use Apple Shortcuts as the explicit bridge when native Apple MCP coverage is insufficient or when the user names a shortcut directly.

  • apple_send_communicationApple Send Communication

    Send a communication through Messages or Mail using Contacts resolution and assistant defaults.

  • apple_send_message_interactiveApple Send Message Interactive

    Send an Apple Messages message, asking for missing recipient or text when needed.

  • apple_set_digest_folderApple Set Digest Folder

    Persist the dedicated Notes folder that Apple-Tools should use for daily and weekly digests.

  • apple_tag_fileApple Tag File

    Read, replace, add, or remove Finder tags on a file or folder through Apple Files.

  • apple_triage_communications_taskApple Triage Communications Task

    Generate a cross-app communications triage summary from unread Messages and Mail search results.

  • apple_undo_actionApple Undo Action

    Undo a recent Apple-Tools action when the underlying standalone MCPs support a reliable reversal.

  • apple_update_contact_preferencesApple Update Contact Preferences

    Persist preferred communication routing for a specific contact so Apple-Tools can choose the right channel and target for that person.

  • apple_update_preferencesApple Update Preferences

    Persist assistant defaults such as default lists, folders, calendars, archive mailboxes, and preferred communication routing.

  • apple_update_system_settingApple Update System Setting

    Apply an assistant-relevant macOS setting through the unified Apple control plane.

  • test_audio_contentConformance Audio Content

    Return audio content for official MCP conformance tests.

  • test_dynamic_prompt

    dynamic

  • test_dynamic_tool
  • test_embedded_resourceConformance Embedded Resource

    Return embedded resource content for official MCP conformance tests.

  • test_image_contentConformance Image Content

    Return image content for official MCP conformance tests.

  • test_input_required_result_capabilities

    Request only client-supported input types.

  • test_input_required_result_elicitation

    Request one elicitation input and return it.

  • test_input_required_result_list_roots

    Request client roots and report their count.

  • test_input_required_result_multi_round

    Complete a two-step input exchange.

  • test_input_required_result_multiple_inputs

    Request several input types in one result.

  • test_input_required_result_request_state

    Round-trip protected request state.

  • test_input_required_result_sampling

    Request one sampling input and return it.

  • test_input_required_result_tampered_state

    Exercise protected request-state validation.

  • test_missing_capability

    Report the standard error when the client lacks sampling support.

  • test_multiple_content_typesConformance Mixed Content

    Return multiple content types for official MCP conformance tests.

  • test_tool_with_progressConformance Progress Tool

    Send progress notifications during execution for official MCP conformance tests.

  • test_trigger_prompt_change

    Trigger a prompt-list change notification.

  • test_trigger_tool_change

    Trigger a tool-list change notification.

Compare and alternatives

    Featured in

    Signals

    Stars
    28
    Forks
    4
    Open issues
    0
    Contributors
    6
    Weekly downloads
    322
    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-tools-mcp
    Version
    1.1.3
    Auth
    No auth
    Packages
    pypi apple-tools-mcpmcpb https://github.com/JonathanRReed/Apple-MCPs/releases/download/v1.1.3/apple-tools-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 Tools (Unified) MCP server. Agent Mart. https://agentmart.dev/connectors/jonathanrreed-apple-tools-mcp (last updated 2026-10-24)