Macuse — AI Superpowers for Every Mac App

Give your AI direct control of Calendar, Mail, Notes, Reminders, Messages, and any other Mac app over the Model Context Protocol — an MCP server for Mac plus Computer Use for macOS, fully on-device.

Works with Claude Desktop, Cursor, Codex, Raycast, VS Code, Warp, Zed, LM Studio, Windsurf, and any MCP-compatible client.

This repo packages the Claude Desktop .mcpb installer for Macuse. The macOS app and full docs live at macuse.app.

What Macuse Does

Two complementary ways for AI to work with your Mac. Everything runs locally — your data never leaves your device.

Native App Integrations

Your AI reads and writes directly to macOS apps through natural conversation.

Computer Use on macOS

See and control any Mac app — even ones without a dedicated integration. Macuse brings Computer Use to macOS for any MCP client, not just Claude or Codex.

• Click any element, type text, navigate menus, drive any app
• Fill out web forms, operate enterprise software, automate APIs that don't exist
• Runs in the background — your cursor and active window stay untouched while AI works in another app

Install for Claude Desktop

Claude Desktop doesn't support remote http:// connectors directly, so this .mcpb is the one-click installer. For other MCP clients, see Use With Other Clients below.

1. Install Macuse:
   • Download from macuse.app/download
   • Drag Macuse.app to /Applications and launch it
   • Grant the permissions the app prompts for
2. Install the bundle: download macuse.mcpb from Releases and double-click to open in Claude Desktop
3. Approve OAuth: approve the authorization prompt that pops up — connection done

To uninstall, remove the entry from Claude Desktop settings.

Use With Other MCP Clients

For clients that accept a custom command (Cursor, Codex, Raycast, VS Code, Warp, Zed, LM Studio, Windsurf, ChatWise, and more), skip this bundle and configure directly:

{
  "mcpServers": {
    "macuse": {
      "command": "/Applications/Macuse.app/Contents/MacOS/macuse",
      "args": ["mcp"]
    }
  }
}

Per-client setup guides: macuse.app/docs/clients.

Privacy & Permissions

• Local-only. All processing stays on your Mac. No cloud, no telemetry of your content.
• Per-app permissions. Allow, deny, or one-time-approve each AI client for each app it touches. Sensitive apps like password managers and banking re-confirm every time. Revoking an AI client automatically clears its app permissions.
• Per-client OAuth. Each MCP client gets its own authorization, manageable in Macuse settings.

How This Bundle Works

macuse-mcp is a thin Node stdio wrapper (~130 LOC). It spawns macuse mcp (the CLI built into the Macuse macOS app) and forwards JSON-RPC over stdin/stdout. All MCP protocol handling, OAuth, and reconnection live inside the Macuse app — this bundle exists solely because Claude Desktop doesn't yet support http:// remote connectors directly.

Override the binary path with the MACUSE_BINARY environment variable (configurable in the Claude Desktop bundle UI). Default: /Applications/Macuse.app/Contents/MacOS/macuse.

Requirements

• macOS 13.0 (Ventura) or later — Apple Silicon or Intel
• Macuse macOS app installed
• Node 20.8.1+ (bundled by Claude Desktop's runtime)

Links

• Website: macuse.app
• Download: macuse.app/download
• Docs: macuse.app/docs
• Pricing: macuse.app/pricing — free tier with daily limits, or one-time Lifetime
• MCP spec: modelcontextprotocol.io

License

This MCPB bundle is MIT-licensed. The Macuse macOS application is a separate commercial product — see macuse.app for details.