
An MCP server for automating and controlling macOS.
An MCP server for automating and controlling macOS.
·
Let your AI assistant use your Mac.
An MCP server for Claude, Cursor and any other MCP client, built on pymacos.
Add it in a minute, and your assistant stops explaining what to do on your Mac and starts doing it.
With uv installed, there's nothing to set up first.
In Claude Code:
claude mcp add macos -- uvx mcp-server-macosIn Cursor, one click:
In Claude Desktop and other clients configured with JSON:
{
"mcpServers": {
"macos": {
"command": "uvx",
"args": ["mcp-server-macos"]
}
}
}No uv? pip install mcp-server-macos, then use mcp-server-macos as the command.
Requires macOS and Python 3.10 or newer.
macOS gives privacy permissions to the app that runs the server (Claude Desktop, your terminal, your editor), not to the server itself.
When a tool needs a permission that's missing, it tells the assistant which one, instead of failing silently.
Bug reports, ideas and pull requests are welcome. CONTRIBUTING.md explains the setup and how to add a tool, which takes one function and its tests. To report a vulnerability, see SECURITY.md.
If the project is useful to you, a star helps other people find it.
Released under the MIT License, free for personal and commercial use.
Not affiliated with or endorsed by Apple Inc. macOS is a trademark of Apple Inc.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add macos -- uvx mcp-server-macos{
"mcpServers": {
"macos": {
"args": [
"mcp-server-macos"
],
"command": "uvx"
}
}
}code --add-mcp '{"name":"macos","args":["mcp-server-macos"],"command":"uvx"}'[mcp_servers.macos]
command = "uvx"
args = ["mcp-server-macos"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/mcp-server-macos to learn what the "Mcp Server Macos" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add macos -- uvx mcp-server-macosThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/mcp-server-macos)Nothing comparable is listed yet.
v0.1.1Release notesv0.1.0Release notesv0.0.1Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "mcp-server-macos" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.