Setup guide

Set up macos-tools-mcp-server in Cursor

communitystdiounmaintained

A Model Context Protocol server that brings macOS system tools directly inside your LLM client. Monitor system performance in real-time, analyze resource usage, search files with advanced patterns, and manage file tags using native macOS APIs.

01Configuration

{
  "mcpServers": {
    "macos-tools-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@tgomareli/macos-tools-mcp"
      ]
    }
  }
}

Add this to .cursor/mcp.json. Generated from the captured install method (npx); the mcpServers shape is shared across Claude Desktop, Cursor, Windsurf, Cline, and VS Code.

02Steps

Make sure Cursor is installed and up to date.
Open .cursor/mcp.json and add the block above (merge into any existing mcpServers).
Provide any required API keys/credentials as environment variables.
Restart Cursor and confirm macos-tools-mcp-server’s tools appear.

03Other runtimes

Claude Desktop Windsurf Cline Continue Goose VS Code OpenAI Agents SDK LangGraph CrewAI

04Provenance

config_sourcegenerated from captured install method

last_checked2026-08-05 01:51Z

sourcesGitHub repo search [p4]

Next step

Want agents that act within guardrails? Apex is the live governed-agent product — paced, capped, and fully-logged actions with approvals before anything runs.

Explore Apex →

See also: server page · is it safe? · alternatives