# mcp-server-macos (pypi · mcp-server-macos)

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

- Trust score: 80/100 (high trust)
- Change this week: +14
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- pypi · `mcp-server-macos`: 80/100 (this document), [markdown](https://verifymcp.io/servers/jeanextreme002-mcp-server-macos/mcp-server-macos.md), [page](https://verifymcp.io/servers/jeanextreme002-mcp-server-macos/mcp-server-macos)

## Channel facts

- Registry: `pypi`
- Package: `mcp-server-macos`
- Version: `1.3.3`
- Transport: `stdio`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - Runs hatchling.build at install time, a recognised build step with no custom scripting around it.
  - 1 of 29 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 100/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to JeanExtreme002/mcp-server-macos).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 4 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 64/100
  - AI-judged instruction clarity (good).
  - 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.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability check failed: the tool surface changed between 0.1.1 and 1.3.3: 1 tool removals, 0 breaking changes, 29 additions.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (97% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 31 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## 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.

### Claude

```bash
claude mcp add jeanextreme002-mcp-server-macos -- uvx mcp-server-macos
```

### Cursor

```json
{
  "mcpServers": {
    "jeanextreme002-mcp-server-macos": {
      "command": "uvx",
      "args": [
        "mcp-server-macos"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "jeanextreme002-mcp-server-macos": {
      "command": "uvx",
      "args": [
        "mcp-server-macos"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add jeanextreme002-mcp-server-macos -- uvx mcp-server-macos
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "jeanextreme002-mcp-server-macos": {
      "type": "local",
      "command": [
        "uvx",
        "mcp-server-macos"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add jeanextreme002-mcp-server-macos --command uvx --arg mcp-server-macos
```

### Hermes

```yaml
mcp_servers:
  jeanextreme002-mcp-server-macos:
    command: "uvx"
    args: ["mcp-server-macos"]
```

### Netclaw

```json
{
  "McpServers": {
    "jeanextreme002-mcp-server-macos": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "mcp-server-macos"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add jeanextreme002-mcp-server-macos -t stdio -c uvx -a mcp-server-macos
```

### Other

```json
{
  "mcpServers": {
    "jeanextreme002-mcp-server-macos": {
      "command": "uvx",
      "args": [
        "mcp-server-macos"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-21 (score 80, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-11-20 (score 65, −15)

- [security regression] Malware scan: pass → unverified

### 2026-11-17 (score 80, +15)

- [security improvement] Malware scan: unverified → pass
- [functional] Package version: 1.3.0 → 1.3.3
- [functional] Package version: 1.3.0 → 1.3.2

### 2026-11-16 (score 65, −16)

- [security regression] Stability: unverified → fail
- [security regression] Tool safety: pass → unverified
- [security regression] 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.
- [functional regression] Tool coverage: 100% → 94%
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] 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

### 2026-11-15 (score 81, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-11-14 (score 66)

First indexed and scored.

## MCP tools (30)

### `get_clipboard` (~53 tokens)

Read the clipboard

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.

Output parameters:

- `change_count` (integer): A counter that goes up each time any app changes the clipboard: compare two readings to know whether something was copied in between.
- `files` (array): The paths of the files on it, as when copied in Finder. Empty when none.
- `has_image` (boolean): Whether it holds an image, which get_clipboard_image returns.
- `text`: The text on the clipboard. Null when it holds no text (an image, say).

### `get_clipboard_image` (~30 tokens)

Get the image on the clipboard

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

### `set_clipboard` (~83 tokens)

Copy text to the clipboard

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

Input parameters:

- `sensitive` (boolean): 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.
- `text` (string, required): The text to put on the clipboard.

Output parameters:

- `result` (string)

### `copy_files_to_clipboard` (~66 tokens)

Copy files to the clipboard

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.

Input parameters:

- `paths` (array, required): The paths of the files and folders to copy. They must exist.

Output parameters:

- `result` (string)

### `copy_image_to_clipboard` (~79 tokens)

Copy an image to the clipboard

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.

Input parameters:

- `path` (string, required): The path of the image file, in any format macOS opens (PNG, JPEG, HEIC, GIF, TIFF, PDF...).

Output parameters:

- `result` (string)

### `clear_clipboard` (~19 tokens)

Clear the clipboard

Empty the clipboard. What it held is gone.

Output parameters:

- `result` (string)

### `wait_for_clipboard_change` (~94 tokens)

Wait for something to be copied

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.

Input parameters:

- `include_sensitive` (boolean): False to wait on past a copy marked as sensitive (a password, from a password manager), for the next one.
- `timeout_seconds` (number): How long to wait, in seconds, before giving up.

Output parameters:

- `text`: The text that was copied. Null when what was copied isn't text (an image, files...).

### `show_alert` (~86 tokens)

Show an alert

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.

Input parameters:

- `detail`: Smaller text under the message.
- `message` (string, required): What the dialog says.
- `timeout_seconds` (number): How long to wait for the user, in seconds, before closing the dialog as if it was cancelled.

Output parameters:

- `result` (string)

### `ask_confirmation` (~103 tokens)

Ask a yes or no question

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

Input parameters:

- `cancel` (string): The label of the button that cancels.
- `message` (string, required): What the dialog says.
- `ok` (string): The label of the button that confirms.
- `timeout_seconds` (number): How long to wait for the user, in seconds, before closing the dialog as if it was cancelled.
- `title`: The dialog's title.

Output parameters:

- `confirmed` (boolean): True when the user clicked the OK button. False when they cancelled, or didn't answer in time.

### `ask_text` (~141 tokens)

Ask for a line of text

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.

Input parameters:

- `default` (string): Text the field starts with. Not a secret: other processes of the user can see it.
- `hidden` (boolean): True to show dots instead of what's typed, for a password.
- `message` (string, required): What the dialog says.
- `timeout_seconds` (number): How long to wait for the user, in seconds, before closing the dialog as if it was cancelled.
- `title`: The dialog's title.

Output parameters:

- `text`: The text. Null when the user cancelled, or didn't answer in time.

### `ask_choice` (~107 tokens)

Ask to pick from a list

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

Input parameters:

- `default`: The option selected when the dialog opens.
- `options` (array, required): The options to pick from.
- `prompt`: What the dialog says above the list.
- `timeout_seconds` (number): How long to wait for the user, in seconds, before closing the dialog as if it was cancelled.
- `title`: The dialog's title.

Output parameters:

- `choice`: The option picked. Null when the user cancelled, or didn't answer in time.

### `ask_for_files` (~128 tokens)

Ask to pick files

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

Input parameters:

- `folder`: The folder the picker opens in.
- `multiple` (boolean): True to let the user pick several files.
- `prompt`: What the picker says.
- `timeout_seconds` (number): 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']).

Output parameters:

- `paths` (array): The paths picked. Empty when the user cancelled, or didn't answer in time.

### `ask_for_folder` (~82 tokens)

Ask to pick a folder

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

Input parameters:

- `folder`: The folder the picker opens in.
- `prompt`: What the picker says.
- `timeout_seconds` (number): How long to wait for the user, in seconds, before closing the dialog as if it was cancelled.

Output parameters:

- `paths` (array): The paths picked. Empty when the user cancelled, or didn't answer in time.

### `check_notification_permission` (~39 tokens)

Check whether notifications are allowed

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.

Output parameters:

- `allowed`: Whether 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.

### `send_notification` (~139 tokens)

Send a notification

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.

Input parameters:

- `message` (string, required): The 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.

Output parameters:

- `result` (string)

### `get_ui_elements` (~234 tokens)

List what an app shows

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.

Input parameters:

- `app`: The app, by name, bundle identifier or path. The app in front by default.
- `include_text` (boolean): Also list what's there to be read (text, headings, images), not only the controls.
- `max_elements` (integer): The most elements to list.

Output parameters:

- `app` (string): The app's name.
- `elements` (array): Top to bottom, as a person reads the window.
- `note`: Something to know about the list, when there is.

### `find_ui_elements` (~152 tokens)

Find an element on screen

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.

Input parameters:

- `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'...

Output parameters:

- `app` (string): The app's name.
- `elements` (array): Top to bottom, as a person reads the window.
- `note`: Something to know about the list, when there is.

### `wait_for_ui_element` (~129 tokens)

Wait for an element

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.

Input parameters:

- `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_seconds` (number): How long to wait at most, in seconds.

Output parameters:

- `element`: The element. Null when there's none.

### `get_focused_ui_element` (~37 tokens)

Get the focused element

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

Output parameters:

- `element`: The element. Null when there's none.

### `get_ui_element_at` (~70 tokens)

Get the element at a point

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

Input parameters:

- `x` (number, required): Across, in points from the left of the main display.
- `y` (number, required): Down, in points from the top of the main display.

Output parameters:

- `element`: The element. Null when there's none.

### `read_ui_element_text` (~73 tokens)

Read an element's text

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.

Input parameters:

- `id` (integer, required): The element's id, from get_ui_elements, find_ui_elements or another tool of these that returned it.

Output parameters:

- `result` (string)

### `list_menu_items` (~100 tokens)

List an app's menu items

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.

Input parameters:

- `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.

Output parameters:

- `result` (array)

### `focus_ui_element` (~63 tokens)

Focus an element

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

Input parameters:

- `id` (integer, required): The element's id, from get_ui_elements, find_ui_elements or another tool of these that returned it.

Output parameters:

- `result` (string)

### `set_ui_element_value` (~102 tokens)

Set an element's value

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.

Input parameters:

- `id` (integer, required): The element's id, from get_ui_elements, find_ui_elements or another tool of these that returned it.
- `value` (required): Text for a text field (it replaces what's there), a number for a slider.

Output parameters:

- `result` (string)

### `press_ui_element` (~103 tokens)

Press an element

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.

Input parameters:

- `id` (integer, required): The element's id, from get_ui_elements, find_ui_elements or another tool of these that returned it.

Output parameters:

- `result` (string)

### `click_ui_element` (~106 tokens)

Click an element

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.

Input parameters:

- `button` (string): 'right' opens a context menu.
- `count` (integer): 2 double-clicks: opens a file in a list.
- `id` (integer, required): The element's id, from get_ui_elements, find_ui_elements or another tool of these that returned it.

Output parameters:

- `result` (string)

### `perform_ui_action` (~106 tokens)

Perform an element's action

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

Input parameters:

- `action` (string, required): One of the element's actions: 'AXShowMenu' opens its menu, 'AXIncrement' and 'AXDecrement' step a slider or a stepper, 'AXConfirm', 'AXCancel', 'AXPick'.
- `id` (integer, required): The element's id, from get_ui_elements, find_ui_elements or another tool of these that returned it.

Output parameters:

- `result` (string)

### `click_menu_item` (~131 tokens)

Choose a menu item

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.

Input parameters:

- `app`: The app, by name, bundle identifier or path. The app in front by default.
- `path` (string, required): The menu, then the item, through any submenus, separated by '>': 'File > Save As…', 'Format > Font > Bold'. '...' stands for '…', and case doesn't matter.

Output parameters:

- `result` (string)

### `find_tools` (~106 tokens)

Find a tool

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.

Input parameters:

- `limit` (integer): The most tools to return.
- `query` (string, required): What 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.

Output parameters:

- `result` (array)

### `enable_toolsets` (~2411 tokens)

Enable toolsets

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…

Input parameters:

- `names` (array, required): The toolsets to add, such as ['pdf'].

Output parameters:

- `added` (array): The tools this call added: callable now.
- `if_missing` (string): What to do if the tools added don't show up in the list of tools.
- `toolsets` (array): Every toolset enabled now.

## Diagnostics

Captured diagnostic sections: Provenance, Install scripts, Dependencies. The full working is on the page: https://verifymcp.io/servers/jeanextreme002-mcp-server-macos/mcp-server-macos#diagnostics

## Score history

- 2026-11-21: 80
- 2026-11-20: 65
- 2026-11-19: 80
- 2026-11-18: 80
- 2026-11-17: 80
- 2026-11-16: 65
- 2026-11-15: 81
- 2026-11-14: 66

## 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.

## Links

- PyPI project: https://pypi.org/project/mcp-server-macos/
- Socket report: https://socket.dev/pypi/package/mcp-server-macos
- Repository: https://github.com/JeanExtreme002/mcp-server-macos
- Changelog RSS feed: https://verifymcp.io/servers/jeanextreme002-mcp-server-macos/mcp-server-macos.xml
- Changelog JSON feed: https://verifymcp.io/servers/jeanextreme002-mcp-server-macos/mcp-server-macos/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/jeanextreme002-mcp-server-macos/mcp-server-macos.json
- HTML version of this page: https://verifymcp.io/servers/jeanextreme002-mcp-server-macos/mcp-server-macos
