mcp-server-macos
Lets Claude, Cursor and other MCP clients control your Mac, built on pymacos
- Pricing
- Open source
- Platforms
- macOS, CLI
- Runs
- Locally
- Version
- 1.3.3
- Listing updated
- today
Similar MCP servers
About mcp-server-macos
mcp-server-macos is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.
Setup is a single command with uv installed: claude mcp add macos -- uvx mcp-server-macos, or an equivalent JSON block for Claude Desktop and a one-click link for Cursor. Without uv, pip install works too. It needs macOS and Python 3.10 or newer.
macOS grants privacy permissions to the app that launches the server, such as Claude Desktop, a terminal or an editor, not to the server itself. When a tool needs a permission that is missing, it tells the assistant which one rather than failing silently.
The project is MIT licensed and not affiliated with Apple. The README says adding a tool takes one function and its tests, which makes it easy to extend. It is at version 0.1.1.
Install
Run in a terminal
claude mcp add mcp-server-macos -- uvx mcp-server-macosAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-server-macos": {
"command": "uvx",
"args": [
"mcp-server-macos"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server-macos": {
"command": "uvx",
"args": [
"mcp-server-macos"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-server-macos": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-server-macos"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-server-macos": {
"command": "uvx",
"args": [
"mcp-server-macos"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-server-macos": {
"command": "uvx",
"args": [
"mcp-server-macos"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
What it does
- One-command install
- Runs through uvx, with a JSON config for Claude Desktop and a one-click Cursor link.
- Built on pymacos
- Uses the pymacos library to act on the Mac.
- Clear permission errors
- Tells the assistant which macOS privacy permission is missing.
- Easy to extend
- A new tool is one function plus its tests.
- MIT licensed
- Free for personal and commercial use.
Good for
- Let an assistant act on your Mac instead of describing steps
- Add Mac control to Claude Code with one command
- Extend the server with your own macOS tool
- Use the same server from Cursor or Claude Desktop
Pricing
Open source
MIT licensed
mcp-server-macos FAQ
What does it require?
macOS and Python 3.10 or newer; uv makes setup a single command.
Who needs to grant macOS permissions?
The app that runs the server, such as Claude Desktop, your terminal or your editor.
What licence is it under?
MIT.
How do I add it to Claude Code?
Run claude mcp add macos -- uvx mcp-server-macos.
Is mcp-server-macos free?
Yes. mcp-server-macos is open source, so you can use and self-host it for free.
How do I add mcp-server-macos to Claude Code?
Run this command in your terminal: claude mcp add mcp-server-macos -- uvx mcp-server-macos
What are the best alternatives to mcp-server-macos?
The closest alternatives to mcp-server-macos are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


