Skip to main content

🍎 mcp-server-macos

Let your AI assistant use your Mac.
An MCP server for Claude, Cursor and any other MCP client, built on pymacos.

MCP server CI: tests on macOS and Linux Newest PyPI version Python 3.10 or newer Platform: macOS Development status License


Add it in a minute, and your assistant stops explaining what to do on your Mac and starts doing it.

Get started

With uv installed, there's nothing to set up first.

In Claude Code:

claude mcp add macos -- uvx mcp-server-macos

In Cursor, one click:

Add mcp-server-macos to Cursor

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.

Permissions

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.

Contributing

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.

License

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.

Metadata

Release files for mcp-server-macos 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-server-macos 0.1.1
File Size Uploaded Provenance Actions
mcp_server_macos-0.1.1.tar.gz 19.7 kB With provenance Details for mcp_server_macos-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mcp-server-macos 0.1.1
File Interpreter ABI Platform Actions
mcp_server_macos-0.1.1-py3-none-any.whl Python 3 none any Details for mcp_server_macos-0.1.1-py3-none-any.whl

Total release size: 29.2 kB

Release files / mcp_server_macos-0.1.1.tar.gz

Download URL mcp_server_macos-0.1.1.tar.gz
Size 19.7 kB
Tags Source
SHA-256 checksum
How to use checksums
e531bbc6eb9fa602517562dd3eae2f502e61b30529cec17eeca0fa489808bc43
BLAKE2b-256 checksum
How to use checksums
7c9e9087bff68de49ecefc1fecc1705a06ff7b751753c00d10315c90eb4c5ab5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

Release files / mcp_server_macos-0.1.1-py3-none-any.whl

Download URL mcp_server_macos-0.1.1-py3-none-any.whl
Size 9.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e4a9b45d7f59738f9e820de05f219b66da77f8bd037a090260586069076b0504
BLAKE2b-256 checksum
How to use checksums
1a36b83bddd9cd2493e38bafdf342ab07bb127fef712549cf08569c59fd842e2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

Security for mcp-server-macos 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for mcp_server_macos-0.1.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page