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.

Toolbox	What you can ask
Calendar	"Schedule a meeting next Tuesday at 3pm", find free time, manage events
Mail	"Draft a reply to this email", search inbox, organize messages
Notes	"Find notes mentioning the Q2 launch", capture ideas, append to notes
Reminders	Create tasks with due dates and priorities, mark complete, search across lists
Messages	Read and send iMessages, search conversations
Stickies	Search, read, and create sticky notes in Apple Stickies
Contacts	Look up by name, email, phone, or company
Maps & Location	Place search, directions, travel time, current location
Shortcuts	Browse installed Shortcuts and run them with optional input

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.

Install Macuse:
- Download from macuse.app/download
- Drag Macuse.app to /Applications and launch it
- Grant the permissions the app prompts for
Install the bundle: download macuse.mcpb from Releases and double-click to open in Claude Desktop
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)

License

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

macuse-mcp