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.

mcp-server-macos

PYPI · MCP-SERVER-MACOS

Let your AI assistant use your Mac: an MCP server for macOS, built on pymacos.

Available components

+14 this week 80 Trust /100

Last scanned (21 hours ago)

Scores higher than 78% of PyPI servers

Category IoT and Hardware

Trust breakdown (7 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 → Why this is hard to 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 hatchling.build at install time, a recognised build step with no custom scripting around it. View diagnostics → Pass
  • 1 of 29 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency100
  • Source repository is publicly reachable at the declared URL. View diagnostics → Pass
  • Cryptographically verified build provenance (signed, bound to JeanExtreme002/mcp-server-macos). View diagnostics → Pass
  • Clear OSI-approved license (MIT).Pass
  • Actively maintained (last published 4 days ago).Pass
  • Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability64
  • AI-judged instruction clarity (good).Pass
  • Context-footprint check failed: tool/resource definitions use about 5401 tokens (~180/item across 30 items; 30 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
  • Stability check failed: the tool surface changed between 0.1.1 and 1.3.3: 1 tool removals, 0 breaking changes, 29 additions. See how to fix → Fail
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
  • Structured output schemas are declared (97% of tools); any adoption earns full credit.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
  • An AI judge read all 31 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a current MCP spec version (2026-07-28).Pass
What we tested

Checks we ran (16)

  • Malware scan
  • Known CVEs
  • Install scripts
  • Dependency health
  • Source repository
  • Provenance
  • License
  • Maintenance
  • Security disclosure
  • Schema quality
  • Stability
  • Tool coverage
  • Injection markers
  • Destructive annotations
  • Judged manipulation
  • MCP protocol

Does not apply to this package (2)

  • Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
  • Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.

The score does not measure everything. What the score does not measure →

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.

  • 21 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
  • 20 Nov 26 −15
    • Malware scan: pass → unverified ▼ security
  • 17 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
    • Package version: 1.3.0 → 1.3.3 functional
    • Package version: 1.3.0 → 1.3.2 functional
  • 16 Nov 26 −16
    • Stability: unverified → fail ▼ security
    • Tool safety: pass → unverified ▼ security
    • Malware scan: pass → unverified ▼ security
    • Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. security
    • Tool coverage: 100% → 94% ▼ functional
    • Capabilities: pass → unverified ▼ functional
    • Tool coverage: 100 → unverified ▼ functional
    • Schema quality: pass → fail ▼ functional
    • First check of Schema quality: unverified functional
    • Package version: 0.1.1 → 1.3.0 functional
    • Package version: 0.1.1 → 1.2.0 functional
    • Package version: 0.1.1 → 1.1.1 functional
  • 15 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
  • 14 Nov 26 66

    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 21 Nov 2026 · Analysed pypi/mcp-server-macos@1.3.3

Provenance Verified

A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.

Result Verified
Ecosystem pypi
Reason Verified
Discovered via Registry attestation endpoint
Source repo JeanExtreme002/mcp-server-macos
Certificate issuer https://token.actions.githubusercontent.com
Certificate SAN https://github.com/JeanExtreme002/mcp-server-macos/.github/workflows/publish.yml@refs/tags/v1.3.3
Rekor log index 3939116207
Predicate type PyPI publish attestation https://docs.pypi.org/attestations/publish/v1
Subject digest sha256:d73e287b5001515dfe0178b05e8a1be9e2b8dbaf4fca6ed7b5b62a90ef61a440

Background: How many MCP packages publish verified provenance →

Install scripts 1 script
Hook Tier Command
build_backend Known build tool hatchling.build

Background: Why install scripts are a supply-chain risk →

Dependencies 29 packages
Packages resolved 29
No linked repository 1
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 30 exposed · ~5,172 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. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
ask_choice ~107

Let the user pick one option from a list, in a dialog. It waits until they answer, or the time runs out.

NameTypeReqDescription
default––The option selected when the dialog opens.
optionsarrayyesThe options to pick from.
prompt––What the dialog says above the list.
timeout_secondsnumber–How long to wait for the user, in seconds, before closing the dialog as if it was cancelled.
title––The dialog's title.
NameTypeReqDescription
choice–yesThe option picked. Null when the user cancelled, or didn't answer in time.

No examples provided.

ask_confirmation ~103

Ask the user a yes or no question in a dialog, and wait for the answer.

NameTypeReqDescription
cancelstring–The label of the button that cancels.
messagestringyesWhat the dialog says.
okstring–The label of the button that confirms.
timeout_secondsnumber–How long to wait for the user, in seconds, before closing the dialog as if it was cancelled.
title––The dialog's title.
NameTypeReqDescription
confirmedbooleanyesTrue when the user clicked the OK button. False when they cancelled, or didn't answer in time.

No examples provided.

ask_for_files ~128

Let the user pick a file, or several, in the system's file picker. It waits until they answer, or the time runs out.

NameTypeReqDescription
folder––The folder the picker opens in.
multipleboolean–True to let the user pick several files.
prompt––What the picker says.
timeout_secondsnumber–How long to wait for the user, in seconds, before closing the dialog as if it was cancelled.
types––Limit the choice, by extension (['pdf', 'png']) or type identifier (['public.image']).
NameTypeReqDescription
pathsarrayyesThe paths picked. Empty when the user cancelled, or didn't answer in time.

No examples provided.

ask_for_folder ~82

Let the user pick a folder in the system's folder picker. It waits until they answer, or the time runs out.

NameTypeReqDescription
folder––The folder the picker opens in.
prompt––What the picker says.
timeout_secondsnumber–How long to wait for the user, in seconds, before closing the dialog as if it was cancelled.
NameTypeReqDescription
pathsarrayyesThe paths picked. Empty when the user cancelled, or didn't answer in time.

No examples provided.

ask_text ~141

Ask the user for a line of text in a dialog, and wait for it. What they type comes back as the result, a password included: ask for one only when the task needs it.

NameTypeReqDescription
defaultstring–Text the field starts with. Not a secret: other processes of the user can see it.
hiddenboolean–True to show dots instead of what's typed, for a password.
messagestringyesWhat the dialog says.
timeout_secondsnumber–How long to wait for the user, in seconds, before closing the dialog as if it was cancelled.
title––The dialog's title.
NameTypeReqDescription
text–yesThe text. Null when the user cancelled, or didn't answer in time.

No examples provided.

check_notification_permission ~39

Check whether send_notification can show notifications, without sending one. A Focus mode such as Do Not Disturb can still hide notifications that are allowed.

Input schema present but exposes no named parameters.

NameTypeReqDescription
allowed–yesWhether macOS lets Script Editor, which posts the notifications, show them. Null when it can't tell: Script Editor has never posted one yet, or the settings couldn't be read.

No examples provided.

clear_clipboard ~19

Empty the clipboard. What it held is gone.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultstringyes–

No examples provided.

click_menu_item ~131

Choose an item of an app's menus, as a click on it would. The app comes to the front first, since its menus act on its window in front. What it does is the app's: an item may delete, send or quit.

NameTypeReqDescription
app––The app, by name, bundle identifier or path. The app in front by default.
pathstringyesThe menu, then the item, through any submenus, separated by '>': 'File > Save As…', 'Format > Font > Bold'. '...' stands for '…', and case doesn't matter.
NameTypeReqDescription
resultstringyes–

No examples provided.

click_ui_element ~106

Click an element's middle with the mouse, bringing its app to the front: for a double-click, a right click, or an element press_ui_element doesn't work on.

NameTypeReqDescription
buttonstring–'right' opens a context menu.
countinteger–2 double-clicks: opens a file in a list.
idintegeryesThe element's id, from get_ui_elements, find_ui_elements or another tool of these that returned it.
NameTypeReqDescription
resultstringyes–

No examples provided.

copy_files_to_clipboard ~66

Put files on the clipboard, replacing what it held, as if they were copied in Finder: pasting in Finder copies them there, and apps like Mail attach them.

NameTypeReqDescription
pathsarrayyesThe paths of the files and folders to copy. They must exist.
NameTypeReqDescription
resultstringyes–

No examples provided.

copy_image_to_clipboard ~79

Put an image on the clipboard, from a file, replacing what it held. Other apps get it as an image copied in Preview, not as a file.

NameTypeReqDescription
pathstringyesThe path of the image file, in any format macOS opens (PNG, JPEG, HEIC, GIF, TIFF, PDF...).
NameTypeReqDescription
resultstringyes–

No examples provided.

enable_toolsets ~2,411

Add toolsets to this server: their tools are listed, and callable, from now on, as the others. Enable only what the task needs: each toolset makes the list of tools longer. The toolsets: - appearance: Tools for the system appearance (Light and Dark mode, the accent color...). Tools: get_appearance, set_appearance, wait_for_appearance_change - apps: Tools for applications: the running and the installed ones, opening, quitting and uninstalling them. Tools: list_running_apps, get_frontmost_app, get_running_app, list_installed_apps, open_app, activate_app, set_app_hidden, quit_app, get_default_app, set_default_app, install_app_from_disk_image, uninstall_app, list_login_items, add_login_item, remove_login_item, check_quarantine, remove_quarantine - audio: Tools for the audio devices, the microphone, and audio files. Tools: get_audio_status, set_audio_output, set_audio_input, set_microphone, get_microphone_level, record_microphone, record_until_silence, get_audio_info, classify_audio, convert_audio, trim_audio, join_audio, fade_audio, change_audio_volume, reverse_audio, change_audio_speed - auth: Tools that ask the user to confirm it's them, with Touch ID or their password. Tools: check_user_authentication, authenticate_user - bluetooth: Tools for Bluetooth: its power and the paired devices. Tools: get_bluetooth_status, set_bluetooth_power, connect_bluetooth_device, disconnect_bluetooth_device - browser: Tools that read and control the tabs of Safari, Chrome and the other Chromium browsers. Tools: list_browser_tabs, get_current_tab, open_in_browser, switch_to_browser_tab, reload_browser_tab, navigate_browser_tab, close_browser_tab, run_javascript_in_browser - camera: Tools for the webcam: the cameras, photos and videos. Tools: list_cameras, take_photo, save_photo, record_video - clipboard: Tools for the clipboard. Tools: get_clipboard, get_clipboard_image, set_clipboard, copy_files_to_clipboard, copy_image_to_clipboard, clear_clipboard, wait_for_clipboard_change - defau…

NameTypeReqDescription
namesarrayyesThe toolsets to add, such as ['pdf'].
NameTypeReqDescription
addedarrayyesThe tools this call added: callable now.
if_missingstringyesWhat to do if the tools added don't show up in the list of tools.
toolsetsarrayyesEvery toolset enabled now.

No examples provided.

find_tools ~106

Search every tool this server has, enabled or not: the best matches first. A tool that isn't enabled yet is called once its toolset is, with enable_toolsets.

NameTypeReqDescription
limitinteger–The most tools to return.
querystringyesWhat the tool should do, in a few words, such as 'encrypt a pdf' or 'take a screenshot'.
toolset––Only this toolset's tools: all of them, whatever the query.
NameTypeReqDescription
resultarrayyes–

No examples provided.

find_ui_elements ~152

Find the elements on screen with a name, a role, or both: the 'Send' button, the search field. Those named exactly so come first ('Save' before "Don't Save"), then the others, top to bottom. Text is found too, not only controls. Give a name, a role, or both.

NameTypeReqDescription
app––The app, by name, bundle identifier or path. The app in front by default.
name––A part of its name, label, text, placeholder or tooltip, in any case.
role––What it is: 'button', 'text field', 'link', 'check box', 'menu item', 'search field'...
NameTypeReqDescription
appstringyesThe app's name.
elementsarrayyesTop to bottom, as a person reads the window.
note––Something to know about the list, when there is.

No examples provided.

focus_ui_element ~63

Bring an element's app to the front and give it the keyboard focus, for type_text or press_keys to go to it.

NameTypeReqDescription
idintegeryesThe element's id, from get_ui_elements, find_ui_elements or another tool of these that returned it.
NameTypeReqDescription
resultstringyes–

No examples provided.

get_clipboard ~53

Read the clipboard: its text, whether it holds an image, and the files on it. What the user copied last may be private (a password, a message): read it when the task calls for it.

Input schema present but exposes no named parameters.

NameTypeReqDescription
change_countintegeryesA counter that goes up each time any app changes the clipboard: compare two readings to know whether something was copied in between.
filesarrayyesThe paths of the files on it, as when copied in Finder. Empty when none.
has_imagebooleanyesWhether it holds an image, which get_clipboard_image returns.
text–yesThe text on the clipboard. Null when it holds no text (an image, say).

No examples provided.

get_clipboard_image ~30

Get the image on the clipboard, as a PNG. Fails when the clipboard holds no image.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_focused_ui_element ~37

Get the element keystrokes go to now (a text field, a list), in whichever app. Null when there's none.

Input schema present but exposes no named parameters.

NameTypeReqDescription
element–yesThe element. Null when there's none.

No examples provided.

get_ui_element_at ~70

Get the element at a point of the screen, in whichever app shows it there: what a click there would reach.

NameTypeReqDescription
xnumberyesAcross, in points from the left of the main display.
ynumberyesDown, in points from the top of the main display.
NameTypeReqDescription
element–yesThe element. Null when there's none.

No examples provided.

get_ui_elements ~234

List what an app shows on screen: its buttons, text fields, links, checkboxes, tabs and menus, each with an id, its name, its value and where it is. Use it to see an app before acting on it, rather than a screenshot: then press_ui_element, set_ui_element_value or click_menu_item with what it gives. Only what can be seen is listed: the window in front, with the panels over it. When a menu, a dialog or a sheet (a save panel) is open, only it is, as nothing else can be used until it closes. Web pages are read too, in Safari, Chrome and Electron apps. Some apps (games, a few cross-platform ones) show little or nothing this way: take a screenshot then.

NameTypeReqDescription
app––The app, by name, bundle identifier or path. The app in front by default.
include_textboolean–Also list what's there to be read (text, headings, images), not only the controls.
max_elementsinteger–The most elements to list.
NameTypeReqDescription
appstringyesThe app's name.
elementsarrayyesTop to bottom, as a person reads the window.
note––Something to know about the list, when there is.

No examples provided.

list_menu_items ~100

List the items of an app's menus, with their keyboard shortcuts: what the app can do, including what no button on screen shows. The app needn't be in front. click_menu_item chooses one.

NameTypeReqDescription
app––The app, by name, bundle identifier or path. The app in front by default.
menu––Only this menu of the menu bar, such as 'File' or 'View'. Every menu by default.
NameTypeReqDescription
resultarrayyes–

No examples provided.

perform_ui_action ~106

Ask an element to do one of its actions, as its actions field lists them.

NameTypeReqDescription
actionstringyesOne of the element's actions: 'AXShowMenu' opens its menu, 'AXIncrement' and 'AXDecrement' step a slider or a stepper, 'AXConfirm', 'AXCancel', 'AXPick'.
idintegeryesThe element's id, from get_ui_elements, find_ui_elements or another tool of these that returned it.
NameTypeReqDescription
resultstringyes–

No examples provided.

press_ui_element ~103

Use an element as a click would: press a button, follow a link, toggle a checkbox, choose a tab or a menu item. It's done through Accessibility: the pointer doesn't move, and the window needn't be in front. What it does is the app's: a button may send, delete or buy.

NameTypeReqDescription
idintegeryesThe element's id, from get_ui_elements, find_ui_elements or another tool of these that returned it.
NameTypeReqDescription
resultstringyes–

No examples provided.

read_ui_element_text ~73

Read all the text an element holds, its own and what's in it, what's scrolled out of view included: a long text area, a message, a dialog.

NameTypeReqDescription
idintegeryesThe element's id, from get_ui_elements, find_ui_elements or another tool of these that returned it.
NameTypeReqDescription
resultstringyes–

No examples provided.

send_notification ~139

Show a notification on this Mac, in the top-right corner of the screen and in Notification Center. macOS shows it as coming from Script Editor. Text over 4096 characters is clipped. Don't put a secret in a notification: other processes of the user can see its text while it's being posted.

NameTypeReqDescription
messagestringyesThe notification's text.
sound––The name of a system alert sound to play, e.g. 'Glass', 'Ping' or 'Basso'. Silent by default.
subtitle––A line between the title and the text.
title––The title, in bold above the text.
NameTypeReqDescription
resultstringyes–

No examples provided.

set_clipboard ~83

Put text on the clipboard, replacing what it held, for the user to paste.

NameTypeReqDescription
sensitiveboolean–True for a password or a token: clipboard managers are asked not to show it or keep it in their history. Any app can still read it, so clear the clipboard after use.
textstringyesThe text to put on the clipboard.
NameTypeReqDescription
resultstringyes–

No examples provided.

set_ui_element_value ~102

Set what an element holds: a text field's text, replacing it, or a slider's position. When the app refuses, or a web form doesn't notice, focus_ui_element and type_text instead.

NameTypeReqDescription
idintegeryesThe element's id, from get_ui_elements, find_ui_elements or another tool of these that returned it.
value–yesText for a text field (it replaces what's there), a number for a slider.
NameTypeReqDescription
resultstringyes–

No examples provided.

show_alert ~86

Show the user an alert with an OK button, and wait until it's dismissed. To tell them something without waiting, send a notification instead.

NameTypeReqDescription
detail––Smaller text under the message.
messagestringyesWhat the dialog says.
timeout_secondsnumber–How long to wait for the user, in seconds, before closing the dialog as if it was cancelled.
NameTypeReqDescription
resultstringyes–

No examples provided.

wait_for_clipboard_change ~94

Wait until the user, or an app, copies something new, and return it. Clearing the clipboard doesn't count. Fails when nothing is copied in time.

NameTypeReqDescription
include_sensitiveboolean–False to wait on past a copy marked as sensitive (a password, from a password manager), for the next one.
timeout_secondsnumber–How long to wait, in seconds, before giving up.
NameTypeReqDescription
text–yesThe text that was copied. Null when what was copied isn't text (an image, files...).

No examples provided.

wait_for_ui_element ~129

Wait until an element shows up (a page loaded, a dialog opened, a button enabled), and return it; null if it doesn't within the timeout. An app that isn't running yet is waited for too.

NameTypeReqDescription
app––The app, by name, bundle identifier or path. The app in front by default.
name––A part of its name, label or text, in any case.
role––What it is: 'button', 'text field', 'link'...
timeout_secondsnumber–How long to wait at most, in seconds.
NameTypeReqDescription
element–yesThe element. Null when there's none.

No examples provided.

Install

How do I install the mcp-server-macos server?

mcp-server-macos runs locally as a PyPI package, launched with uvx mcp-server-macos. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

pypi · mcp-server-macos

# add to Claude Code
claude mcp add jeanextreme002-mcp-server-macos -- uvx mcp-server-macos
Common questions

What is the mcp-server-macos server?

mcp-server-macos is listed in the public MCP registry as io.github.JeanExtreme002/mcp-server-macos. Let your AI assistant use your Mac: an MCP server for macOS, built on pymacos. This page covers its PyPI package (mcp-server-macos).

Is the mcp-server-macos server safe to use?

mcp-server-macos scores 80 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the mcp-server-macos server expose?

mcp-server-macos exposes 30 tools: get_clipboard, get_clipboard_image, set_clipboard, copy_files_to_clipboard, copy_image_to_clipboard, and 25 more. Their descriptions and schemas cost roughly 5,172 tokens of context every time the server is loaded.

Is the mcp-server-macos server still maintained?

mcp-server-macos is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the mcp-server-macos server under?

mcp-server-macos declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

What did VerifyMCP test on the mcp-server-macos server?

VerifyMCP ran 16 checks on mcp-server-macos, covering Malware scan, Known CVEs, Install scripts, Dependency health and 12 more. Endpoint Security and Transport & Reachability do not apply to a PyPI package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.