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 System

PYPI · APPLE-SYSTEM-MCP · 2 COMPONENTS · SCANNED AUG 17

Read and manage macOS system settings and perform scoped desktop actions.

+5 this week 69 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 31 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency35
Schema Quality & AI Usability73
  • 80% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Partial
  • AI-judged instruction clarity (good).Pass
  • Tool/resource definitions use about 1348 tokens (~31/item across 43 items; 39 tools + 4 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management37
  • Stability observed for 11 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-system-mcp

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

  • 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 0
    • 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
    • MCP protocol: unverified → pass functional
    • Schema quality: unverified → 80 functional
    • First check of Tool coverage: 100 functional
    • First check of Schema quality: good functional
    • First check of Tool coverage: 0 functional
    • First check of Schema quality: fail functional
    • First check of Schema quality: pass 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 17 Aug 2026 · Analysed pypi/apple-system-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 31 packages
Packages resolved 31
Stale 1
No linked repository 1
Tree resolution Complete
MCP tools · 39 exposed · ~1,212 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
get_tool_info ~48

Load the full schema, examples, and metadata for one tool from this server.

NameTypeReqDescription
include_examplesboolean
include_schemaboolean
namestringyes

Structured output declared, but exposes no named fields.

No examples provided.

search_tools ~50

Search this server's tool catalog by keyword, alias, or domain tag.

NameTypeReqDescription
domain_tags
limitinteger
modestring
querystringyes

Structured output declared, but exposes no named fields.

No examples provided.

system_get_accessibility_settings ~25

Read common macOS accessibility settings such as reduce motion and increase contrast.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultyes

No examples provided.

system_get_appearance_settings ~27

Read current macOS appearance settings such as light or dark mode and accent color.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultyes

No examples provided.

system_get_battery ~19

Get the current battery state from macOS.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultyes

No examples provided.

system_get_clipboard ~17

Read the current text clipboard contents.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultyes

No examples provided.

system_get_context_snapshot ~29

Return a richer macOS context snapshot, including battery, frontmost app, and Focus metadata.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultyes

No examples provided.

system_get_dock_settings ~29

Read common macOS Dock settings such as autohide, magnification, and orientation.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultyes

No examples provided.

system_get_finder_settings ~30

Read common macOS Finder settings such as path bar, status bar, and preferred view style.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultyes

No examples provided.

system_get_focus_status ~23

Return truthful Focus support metadata and the best available current Focus state.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultyes

No examples provided.

system_get_frontmost_app ~21

Get the name of the current frontmost application.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultyes

No examples provided.

system_get_prompt ~33

Fallback prompt rendering tool for tool-only MCP clients.

NameTypeReqDescription
arguments_json
namestringyes

Structured output declared, but exposes no named fields.

No examples provided.

system_get_settings_snapshot ~27

Return a combined read-only snapshot of appearance, accessibility, Dock, and Finder settings.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultyes

No examples provided.

system_gui_choose_popup_value ~61

Choose a value from a named pop-up button in the frontmost window. This is a GUI fallback tool.

NameTypeReqDescription
application
bundle_id
description
labelyes
valuestringyes
NameTypeReqDescription
resultyes

No examples provided.

system_gui_click_button ~55

Click a named button in the frontmost window. This is a GUI fallback tool.

NameTypeReqDescription
application
bundle_id
description
indexinteger
label
NameTypeReqDescription
resultyes

No examples provided.

system_gui_click_menu_path ~54

Click a menu path in an application, for example ['File', 'New Window']. This is a GUI fallback tool.

NameTypeReqDescription
application
bundle_id
menu_patharrayyes
NameTypeReqDescription
resultyes

No examples provided.

system_gui_list_menu_bar_items ~41

List the top-level menu bar items for an application. This is a GUI fallback tool.

NameTypeReqDescription
application
bundle_id
NameTypeReqDescription
resultyes

No examples provided.

system_gui_press_keys ~51

Press a key or key chord in the target application. This is a GUI fallback tool.

NameTypeReqDescription
application
bundle_id
keystringyes
modifiers
NameTypeReqDescription
resultyes

No examples provided.

system_gui_type_text ~44

Type text into the frontmost focused control. This is a GUI fallback tool.

NameTypeReqDescription
application
bundle_id
textstringyes
NameTypeReqDescription
resultyes

No examples provided.

system_health ~16

Report the active Apple System MCP configuration.

Input schema present but exposes no named parameters.

NameTypeReqDescription
capabilitiesarrayyes
okboolean
safety_modestringyes
server_namestringyes
supportsarrayyes
transportstringyes
versionstringyes

No examples provided.

system_list_prompts ~21

Fallback prompt discovery tool for tool-only MCP clients.

Input schema present but exposes no named parameters.

Structured output declared, but exposes no named fields.

No examples provided.

system_list_running_apps ~16

List currently running foreground applications.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultyes

No examples provided.

system_list_settings_domains ~23

List the common macOS preference domains exposed by Apple System MCP.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultyes

No examples provided.

system_open_application ~29

Open an application by name using macOS.

NameTypeReqDescription
application
bundle_id
NameTypeReqDescription
resultyes

No examples provided.

system_permission_guide ~22

Explain what system access this MCP may need on macOS.

Input schema present but exposes no named parameters.

Structured output declared, but exposes no named fields.

No examples provided.

system_read_preference_domain ~44

Read a macOS preference domain through defaults export for a production-safe, structured settings view.

NameTypeReqDescription
current_hostboolean
domainstringyes
NameTypeReqDescription
resultyes

No examples provided.

system_set_appearance_mode ~28

Set macOS appearance mode to light or dark.

NameTypeReqDescription
modestringyes
NameTypeReqDescription
resultyes

No examples provided.

system_set_clipboard ~25

Write text into the macOS clipboard.

NameTypeReqDescription
textstringyes
NameTypeReqDescription
resultyes

No examples provided.

system_set_dock_autohide ~28

Enable or disable Dock autohide.

NameTypeReqDescription
enabledbooleanyes
NameTypeReqDescription
resultyes

No examples provided.

system_set_dock_show_recents ~29

Enable or disable recent applications in the Dock.

NameTypeReqDescription
enabledbooleanyes
NameTypeReqDescription
resultyes

No examples provided.

system_set_finder_path_bar ~27

Show or hide the Finder path bar.

NameTypeReqDescription
enabledbooleanyes
NameTypeReqDescription
resultyes

No examples provided.

system_set_finder_status_bar ~27

Show or hide the Finder status bar.

NameTypeReqDescription
enabledbooleanyes
NameTypeReqDescription
resultyes

No examples provided.

system_set_increase_contrast ~29

Enable or disable macOS increase contrast accessibility mode.

NameTypeReqDescription
enabledbooleanyes
NameTypeReqDescription
resultyes

No examples provided.

system_set_reduce_motion ~27

Enable or disable macOS reduce motion accessibility mode.

NameTypeReqDescription
enabledbooleanyes
NameTypeReqDescription
resultyes

No examples provided.

system_set_reduce_transparency ~28

Enable or disable macOS reduce transparency accessibility mode.

NameTypeReqDescription
enabledbooleanyes
NameTypeReqDescription
resultyes

No examples provided.

system_set_show_all_extensions ~27

Show or hide filename extensions in macOS.

NameTypeReqDescription
enabledbooleanyes
NameTypeReqDescription
resultyes

No examples provided.

system_set_show_hidden_files ~26

Show or hide hidden files in Finder.

NameTypeReqDescription
enabledbooleanyes
NameTypeReqDescription
resultyes

No examples provided.

system_show_notification ~35

Display a local macOS notification.

NameTypeReqDescription
bodystringyes
subtitle
titlestringyes
NameTypeReqDescription
resultyes

No examples provided.

system_status ~21

Return current battery, frontmost app, and running app count.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultyes

No examples provided.