Macos Defaults

🚀 MCP Server for macOS Default Settings

This is an MCP server designed to read/write macOS defaults (settings).

🚀 Quick Start

📦 Installation

For Claude Desktop

• On macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• On Windows: %APPDATA%/Claude/claude_desktop_config.json

✨ Features

🛠️ Tools

• list-domains:
  • Equivalent to running defaults domains.
• find:
  • Equivalent to running defaults find <word>.
• defaults-read:
  • Equivalent to running defaults read <domain> <key>.
  • If key is not provided, it reads the entire domain.
• defaults-write:
  • Equivalent to running defaults write <domain> <key> <value>.

🔧 Technical Details

🏗️ Build and Release

To prepare the distribution package:

1. Synchronize dependencies and update the lock file:

uv sync

2. Build the package distribution:

uv build

This will create source and wheel distributions in the dist/ directory. 3. Publish to PyPI:

uv publish

Note: You need to set PyPI credentials via environment variables or command-line arguments:

• Token: --token or UV_PUBLISH_TOKEN
• Or username/password: --username/UV_PUBLISH_USERNAME and --password/UV_PUBLISH_PASSWORD

🐞 Debugging

Since the MCP server runs via stdio, debugging can be challenging. For the best debugging experience, we highly recommend using MCP Inspector.

You can start the MCP Inspector using this command via npm:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-server-macos-defaults run mcp-server-macos-defaults

After starting, the Inspector will display a URL that you can access in your browser to start debugging.