Skip to content

v1.0.0

Choose a tag to compare

@JeanExtreme002 JeanExtreme002 released this 16 Nov 02:55
· 40 commits to main since this release
7478a08

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 (or MCP_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.