Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

Apple Tools (Unified)

PYPI · APPLE-TOOLS-MCP · 2 COMPONENTS · SCANNED AUG 18

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

+6 this week 68 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security100
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • Runs setuptools.build_meta at install time, a recognised native-build step with no shell scripting around it. View diagnostics → Pass
  • 2 of 41 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency35
Schema Quality & AI Usability63
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (poor).Fail
  • Tool/resource definitions use about 8693 tokens (~42/item across 203 items; 184 tools + 19 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management40
  • Stability observed for 12 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage71
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 0% of tool parameters carry a description.Fail
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
  • Implements a current MCP spec version (2026-07-28).Pass
Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

pypi · apple-tools-mcp

# add to Claude Code
claude mcp add jonathanrreed-apple-tools-mcp -- uvx apple-tools-mcp
# add to Codex CLI
codex mcp add jonathanrreed-apple-tools-mcp -- uvx apple-tools-mcp
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "jonathanrreed-apple-tools-mcp": {
      "type": "local",
      "command": [
        "uvx",
        "apple-tools-mcp"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add jonathanrreed-apple-tools-mcp --command uvx --arg apple-tools-mcp
# ~/.hermes/config.yaml
mcp_servers:
  jonathanrreed-apple-tools-mcp:
    command: "uvx"
    args: ["apple-tools-mcp"]
// mcp.json
{
  "mcpServers": {
    "jonathanrreed-apple-tools-mcp": {
      "command": "uvx",
      "args": [
        "apple-tools-mcp"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 18 Aug 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 37 to 40. That category is still filling its 30-day observation window: 11 days of observed history at the previous scan, 12 at this one. The score rises as the window fills, whether or not the server changes.

  • 16 Aug 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 30 to 33. That category is still filling its 30-day observation window: 9 days of observed history at the previous scan, 10 at this one. The score rises as the window fills, whether or not the server changes.

  • 14 Aug 26 +4
    • Stability: unverified → 0.27 functional
  • 11 Aug 26 −2
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 7 Aug 26 0
    • Security disclosure: fail → pass functional
  • 6 Aug 26 +28
    • Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
    • Tool coverage: unverified → 100 functional
    • Schema quality: unverified → 100 functional
    • MCP protocol: unverified → pass functional
    • First check of Tool coverage: 0 functional
    • First check of Schema quality: fail functional
    • First check of Schema quality: pass functional
    • First check of Schema quality: good functional
    • First check of Tool coverage: 100 functional
  • 5 Aug 26 36

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 18 Aug 2026 · Analysed pypi/apple-tools-mcp@1.0.2

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem pypi
Install scripts 1 script
Hook Tier Command
build_backend allowlisted setuptools.build_meta
Dependencies 41 packages
Packages resolved 41
Stale 1
No linked repository 1
Tree resolution Complete
MCP tools · 184 exposed · ~8,033 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
apple_archive_message ~52

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

NameTypeReqDescription
archive_account
archive_mailbox
message_idstringyes
NameTypeReqDescription
resultyes

No examples provided.

apple_capture_follow_up_from_mail ~76

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

NameTypeReqDescription
create_noteboolean
create_reminderboolean
due_date
message_idstringyes
note_title
reminder_title
NameTypeReqDescription
resultyes

No examples provided.

apple_control_frontmost_app ~94

Use the unified Apple control plane for bounded GUI fallback actions when a native app-domain tool cannot complete the task.

NameTypeReqDescription
actionstringyes
application
bundle_id
description
indexinteger
key
label
menu_path
modifiers
text
value
NameTypeReqDescription
resultyes

No examples provided.

apple_create_event_interactive ~65

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

NameTypeReqDescription
all_dayboolean
calendar_id
end_iso
location
notes
start_iso
title
NameTypeReqDescription
resultyes

No examples provided.

apple_create_note_with_defaults ~56

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

NameTypeReqDescription
body_html
body_text
folder_id
tags
titlestringyes
NameTypeReqDescription
resultyes

No examples provided.

apple_create_reminder_with_defaults ~56

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

NameTypeReqDescription
due_date
list_id
notes
priority
titlestringyes
NameTypeReqDescription
resultyes

No examples provided.

apple_detect_defaults ~28

Detect sensible default mail, calendar, reminders, and notes targets, then persist them if missing.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultyes

No examples provided.

apple_detect_digest_folder ~28

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

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultyes

No examples provided.

apple_ensure_digest_folder ~48

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

NameTypeReqDescription
account_name
folder_namestring
NameTypeReqDescription
resultyes

No examples provided.

apple_event_collaboration_summary ~37

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

NameTypeReqDescription
event_idstringyes
NameTypeReqDescription
resultyes

No examples provided.

apple_find_duplicate_contacts ~41

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

NameTypeReqDescription
merge_candidates_onlyboolean
query
NameTypeReqDescription
resultyes

No examples provided.

apple_generate_daily_briefing ~44

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

NameTypeReqDescription
mail_limitinteger
mail_querystring

Structured output declared, but exposes no named fields.

No examples provided.

apple_generate_weekly_briefing ~51

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

NameTypeReqDescription
daysinteger
mail_limitinteger
mail_querystring

Structured output declared, but exposes no named fields.

No examples provided.

apple_get_focus_status ~22

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

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultyes

No examples provided.

apple_get_preferences ~21

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

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultyes

No examples provided.

apple_get_prompt ~34

Fallback prompt rendering tool for clients that only support tools.

NameTypeReqDescription
arguments_json
namestringyes
NameTypeReqDescription
resultyes

No examples provided.

apple_get_system_context ~29

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

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultyes

No examples provided.

apple_health ~19

Report aggregated health across the unified Apple ecosystem MCP domains.

Input schema present but exposes no named parameters.

NameTypeReqDescription
domainsobjectyes
okboolean
server_namestringyes
transportstringyes
versionstringyes

No examples provided.

apple_list_prompts ~22

Fallback prompt discovery tool for clients that only support tools.

Input schema present but exposes no named parameters.

Structured output declared, but exposes no named fields.

No examples provided.

apple_list_recent_actions ~30

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

NameTypeReqDescription
limit
NameTypeReqDescription
resultyes

No examples provided.

apple_list_shortcuts_for_capability ~50

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

NameTypeReqDescription
limit
querystringyes
NameTypeReqDescription
resultyes

No examples provided.

apple_maps_get_directions_strict ~52

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

NameTypeReqDescription
destinationstringyes
originstringyes
transportstring
NameTypeReqDescription
resultyes

No examples provided.

apple_maps_search_places_strict ~44

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

NameTypeReqDescription
limitinteger
querystringyes
NameTypeReqDescription
resultyes

No examples provided.

apple_open_application ~36

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

NameTypeReqDescription
application
bundle_id
NameTypeReqDescription
resultyes

No examples provided.

apple_open_file_path ~33

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

NameTypeReqDescription
pathstringyes
NameTypeReqDescription
resultyes

No examples provided.

apple_overview ~21

Return an aggregated Apple ecosystem overview using the standalone domain resources.

Input schema present but exposes no named parameters.

NameTypeReqDescription
okboolean
overviewobjectyes

No examples provided.

apple_permission_guide ~34

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

NameTypeReqDescription
domainstring
NameTypeReqDescription
can_prompt_in_appbooleanyes
domainstringyes
notesarrayyes
okboolean
requires_manual_system_settingsbooleanyes
stepsarrayyes

No examples provided.

apple_prepare_communication ~44

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

NameTypeReqDescription
preferred_channel
recipientstringyes
NameTypeReqDescription
resultyes

No examples provided.

apple_prepare_unique_contact ~41

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

NameTypeReqDescription
querystringyes
NameTypeReqDescription
resultyes

No examples provided.

apple_preview_archive_message ~45

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

NameTypeReqDescription
archive_account
archive_mailbox
message_idstringyes
NameTypeReqDescription
resultyes

No examples provided.

apple_preview_communication ~65

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

NameTypeReqDescription
attachments
from_account
messagestringyes
preferred_channel
recipientstringyes
subjectstring
NameTypeReqDescription
resultyes

No examples provided.

apple_preview_create_note_with_defaults ~58

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

NameTypeReqDescription
body_html
body_text
folder_id
tags
titlestringyes
NameTypeReqDescription
resultyes

No examples provided.

apple_preview_create_reminder_with_defaults ~58

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

NameTypeReqDescription
due_date
list_id
notes
priority
titlestringyes
NameTypeReqDescription
resultyes

No examples provided.

apple_preview_follow_up_from_mail ~74

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

NameTypeReqDescription
create_noteboolean
create_reminderboolean
due_date
message_idstringyes
note_title
reminder_title
NameTypeReqDescription
resultyes

No examples provided.

apple_recheck_permissions ~32

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

Input schema present but exposes no named parameters.

NameTypeReqDescription
domainsobjectyes
okboolean
server_namestringyes
transportstringyes
versionstringyes

No examples provided.

apple_reveal_in_finder ~30

Reveal a file or folder in Finder through Apple Files.

NameTypeReqDescription
pathstringyes
NameTypeReqDescription
resultyes

No examples provided.

apple_route_or_run_shortcut ~71

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

NameTypeReqDescription
dry_runboolean
input_paths
input_text
requeststringyes
shortcut_name_or_identifier
NameTypeReqDescription
resultyes

No examples provided.

apple_send_communication ~62

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

NameTypeReqDescription
attachments
from_account
messagestringyes
preferred_channel
recipientstringyes
subjectstring
NameTypeReqDescription
resultyes

No examples provided.

apple_send_message_interactive ~36

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

NameTypeReqDescription
recipient
text
NameTypeReqDescription
resultyes

No examples provided.

apple_set_digest_folder ~48

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

NameTypeReqDescription
account_name
folder_idstringyes
folder_name
NameTypeReqDescription
resultyes

No examples provided.

apple_suggest_calendars ~45

Apple Suggest Calendars using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.

NameTypeReqDescription
limit
query
NameTypeReqDescription
countintegeryes
domainstringyes
okboolean
suggestionsarrayyes

No examples provided.

apple_suggest_contacts ~42

Apple Suggest Contacts using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.

NameTypeReqDescription
limit
query
NameTypeReqDescription
countintegeryes
domainstringyes
okboolean
suggestionsarrayyes

No examples provided.

apple_suggest_files ~42

Apple Suggest Files using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.

NameTypeReqDescription
limit
query
NameTypeReqDescription
countintegeryes
domainstringyes
okboolean
suggestionsarrayyes

No examples provided.

apple_suggest_mailboxes ~44

Apple Suggest Mailboxes using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.

NameTypeReqDescription
limit
query
NameTypeReqDescription
countintegeryes
domainstringyes
okboolean
suggestionsarrayyes

No examples provided.

apple_suggest_message_conversations ~45

Apple Suggest Message Conversations using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.

NameTypeReqDescription
limit
query
NameTypeReqDescription
countintegeryes
domainstringyes
okboolean
suggestionsarrayyes

No examples provided.

apple_suggest_note_folders ~46

Apple Suggest Note Folders using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.

NameTypeReqDescription
limit
query
NameTypeReqDescription
countintegeryes
domainstringyes
okboolean
suggestionsarrayyes

No examples provided.

apple_suggest_places ~42

Apple Suggest Places using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.

NameTypeReqDescription
limit
query
NameTypeReqDescription
countintegeryes
domainstringyes
okboolean
suggestionsarrayyes

No examples provided.

apple_suggest_reminder_lists ~45

Apple Suggest Reminder Lists using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.

NameTypeReqDescription
limit
query
NameTypeReqDescription
countintegeryes
domainstringyes
okboolean
suggestionsarrayyes

No examples provided.

apple_suggest_running_apps ~44

Apple Suggest Running Apps using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.

NameTypeReqDescription
limit
query
NameTypeReqDescription
countintegeryes
domainstringyes
okboolean
suggestionsarrayyes

No examples provided.

apple_suggest_shortcuts ~44

Apple Suggest Shortcuts using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.

NameTypeReqDescription
limit
query
NameTypeReqDescription
countintegeryes
domainstringyes
okboolean
suggestionsarrayyes

No examples provided.