Repository navigation
v1.0.0
pip install --upgrade mcp-server-macos
The first stable release: everything pymacos can do on a Mac is now a tool your assistant can use. From 1.0.0 on, the tools' names, arguments and results change only in a major release.
New
- Tools for all of pymacos, grouped in toolsets:
- The Mac: system, power, volume, sound, appearance, language, settings, defaults, network, bluetooth, printer, Time Machine.
- Apps and windows: apps, launch, windows, Dock, Finder, Spotlight, schedule, shortcuts.
- Input and screen: keyboard, mouse, trackpad, screen, hotkeys, events.
- Media and files: image, PDF, document, video, audio, vision, camera, music, speech.
- Everyday: clipboard, notifications, dialogs, browser, maps, keychain, Touch ID (
auth).
- Permissions handled for you: when a tool needs a privacy permission that's missing, macOS is asked to show its prompt. If it stays missing, the assistant is told what to allow and where.
- Annotated tools: each tool says whether it only reads, adds, replaces, may lose data, or reaches beyond the Mac, so a client can ask before the risky ones.
- Fewer tools when you want them:
--toolsets(orMCP_SERVER_MACOS_TOOLSETS) offers only the toolsets you name, such as--toolsets screen,windows,keyboard,mouse. - Long actions don't block the server: waiting for a system event and recording a video run in a process of their own, so the server keeps answering meanwhile.
Changed
- Requires pymacos 1.39 or newer.
- The package's status is Production/Stable, from Alpha.
Fixed
Found by running every tool on a real Mac before this release, and fixed in pymacos 1.39:
- Blurring or replacing the background of a webcam photo found no person.
- Dialogs that pick from a list, a file or a folder waited forever.
- JavaScript errors in a browser came back as an empty result.
- An app that had just been scripted was sometimes taken for quit.
See the README for how to add the server to a client.