Skip to content

Releases

v1.3.3

Choose a tag to compare

@JeanExtreme002 JeanExtreme002 released this 17 Nov 01:19
3292c9f

pip install --upgrade mcp-server-macos

Changed

  • The repository has a glama.json naming its maintainer, for the server's listing on Glama. The server itself is the same as 1.3.2.

v1.3.2

Choose a tag to compare

@JeanExtreme002 JeanExtreme002 released this 16 Nov 23:27
a90a9d5

pip install --upgrade mcp-server-macos

A small one: PyPI now links to these release notes as the project's changelog. Nothing changes in how the server works.

Changed

  • The changelog is linked on PyPI, in the sidebar with the other links: it's the GitHub Releases.

See the README for how to add the server to a client, including the one-click extension for Claude Desktop.

v1.3.1

Choose a tag to compare

@JeanExtreme002 JeanExtreme002 released this 16 Nov 23:19
3d48e87

pip install --upgrade mcp-server-macos

The server can now be installed in Claude Desktop in one click, and its page says what it does. Nothing changes in how it works.

New

  • A Claude Desktop extension. Each release now comes with mcp-server-macos.mcpb: download it, open it, and Claude Desktop adds the server, with no config file to edit. It installs this version from PyPI, the same one uvx mcp-server-macos runs.

Changed

  • The README (also the PyPI page) shows what the server does:
    • example requests and the tools by area;
    • why it can be trusted (no shell, annotations so your client asks first, no telemetry);
    • which permissions macOS asks for, and its limitations.

See the README for how to add the server to a client.

v1.3.0

Choose a tag to compare

@JeanExtreme002 JeanExtreme002 released this 16 Nov 22:43
ac7a45c

pip install --upgrade mcp-server-macos

Your assistant now starts with the tools that see and use what an app shows, in every client. Asked to do something in an app, it reads its buttons, fields and menus and uses them by id. It no longer takes screenshots because it never knew there was another way.

Changed

  • The ui toolset starts listed, with clipboard, dialog and notifications. Until now, only Claude Code listed it from the start; Claude Desktop, Cursor and the other clients had to turn it on first (enable_toolsets). The server's instructions also tell your assistant to use get_ui_elements rather than a screenshot to do something in an app.
  • What a client is sent at the start grows, from about 7k tokens to about 13k, for the 13 tools of ui. Claude Code is unchanged: it already listed every tool, loading their descriptions only when searched for. To start lighter, choose the toolsets with --toolsets (or MCP_SERVER_MACOS_TOOLSETS), as before.

See the README for how to add the server to a client.

v1.2.0

Choose a tag to compare

@JeanExtreme002 JeanExtreme002 released this 16 Nov 19:15
852712d

pip install --upgrade mcp-server-macos

Your assistant can now see what an app shows (its buttons, text fields, links, checkboxes, tabs and menus) as text, and use them by name: no screenshot to find what to click, and no coordinates to guess. A model without vision can operate apps too.

New

  • The ui toolset, over the Accessibility tree. Like the other toolsets, your assistant turns it on when a task needs it (enable_toolsets), or you list it with --toolsets.
    • Seeing: get_ui_elements lists what an app shows, each element with an id, its name, its value and where it is. find_ui_elements and wait_for_ui_element look for one by name or role, exact names first ("Save" before "Don't Save"). get_focused_ui_element tells where keystrokes go, get_ui_element_at what's at a point, and read_ui_element_text reads all the text an element holds, scrolled out of view included.
    • Using: press_ui_element, click_ui_element, set_ui_element_value, focus_ui_element and perform_ui_action act on an element by its id. list_menu_items gives an app's menus with their keyboard shortcuts, and click_menu_item chooses one by its path (File > Export > PDF…).
    • Cheap to read: a field left out is empty, so a button costs {id, role, name, x, y, width, height}, and get_ui_elements lists 300 elements at most unless asked for more. An element the app doesn't place has no position, rather than 0, 0. An id is never reused while the server runs; one from long ago asks for the list again.
    • Safe by default: every tool needs Accessibility, asked for as the windows tools do. Pressing, clicking, acting and choosing a menu item are marked open ended, since what a button does is the app's (send, delete, buy), so your client asks you first.

Changed

  • pymacos 1.40 or newer is required, for macos.ui. pip install --upgrade mcp-server-macos brings it.
  • The server's instructions mention what apps show among what it covers, so your assistant looks for these tools before taking a screenshot.

See the README for how to add the server to a client.

v1.1.1

Choose a tag to compare

@JeanExtreme002 JeanExtreme002 released this 16 Nov 04:56
8ee54f0

pip install --upgrade mcp-server-macos

A fix to 1.1.0's tools on demand: your assistant could miss a tool that was there and do the task another way, such as writing a script to decrypt a PDF rather than using decrypt_pdf.

Fixed

  • In Claude Code, every tool is listed again from the start. Claude Code loads a tool's details only when your assistant looks for it, so this costs it the tools' names only. With just the core tools listed, no name told your assistant that the others existed. If you choose the toolsets yourself with --toolsets, your choice is kept.
  • In other clients, enable_toolsets now names every tool, group by group, so your assistant sees everything it can turn on (about 1.5k tokens more at start).
  • The pdf toolset's description mentioned encrypting but not decrypting.
  • The server's instructions ask your assistant to look for a tool here before writing a script or installing a library.

See the README for how to add the server to a client.

v1.1.0

Choose a tag to compare

@JeanExtreme002 JeanExtreme002 released this 16 Nov 04:06
6479f76

pip install --upgrade mcp-server-macos

The server now starts light: your assistant is sent a few tools at first, and turns on the groups of tools a task needs, rather than receiving every tool before your first question. Every tool is still there, as it was.

New

  • Tools on demand. Two tools reach every other one:

    • find_tools searches every tool, on or not, by what it does;
    • enable_toolsets turns on groups of tools while the server runs, and tells your client its list of tools changed.

    A tool turned on this way is exactly the one you had before, so your client still asks before the tools that change or delete something.

Changed

  • What your assistant receives at start: about 5k tokens, from about 115k. The server starts with the clipboard, dialog and notifications tools, and your assistant adds the rest as a task needs it.
  • To keep every tool listed from the start, as before, add --toolsets all to the command (or set MCP_SERVER_MACOS_TOOLSETS=all). Do it if your client doesn't show the tools your assistant turns on. Claude Code shows them; other clients may not, and if not, your assistant tells you what to do.
  • Lighter schemas: the tools' schemas no longer carry the title of every argument, which changed nothing they accept or return.

See the README for how to add the server to a client.

v1.0.0

Choose a tag to compare

@JeanExtreme002 JeanExtreme002 released this 16 Nov 02:55
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.

v0.1.1

Choose a tag to compare

@JeanExtreme002 JeanExtreme002 released this 14 Nov 08:48
6a9216f

pip install --upgrade mcp-server-macos

A release for how the project is found and presented: the tools are the same as in 0.1.0.

New

  • The server is listed in the MCP Registry, as io.github.JeanExtreme002/mcp-server-macos.
  • A new README, with an Add to Cursor button.

See the README for how to add the server to a client.

v0.1.0

Choose a tag to compare

@JeanExtreme002 JeanExtreme002 released this 14 Nov 07:12
7db0278

pip install --upgrade mcp-server-macos

The first working release: an MCP server, built on pymacos, that an MCP client launches with uvx mcp-server-macos. It replaces the 0.0.1 placeholder, which only reserved the name.

New

  • The mcp-server-macos command (also python -m mcp_server_macos), which runs the server over stdio.
  • get_system_info: the macOS version and build, the Mac's model, processor, memory and name, and how long it has been running.
  • send_notification: shows a notification, with an optional title, subtitle and sound.

Requires Python 3.10 or newer and pymacos 1.38 or newer. See the README for how to add the server to a client.