{
  "markdown": "# Macuse — AI Superpowers for Every Mac App\n\nGive your AI direct control of Calendar, Mail, Notes, Reminders, Messages, and any other Mac app over the [Model Context Protocol](https://modelcontextprotocol.io) — an MCP server for Mac plus Computer Use for macOS, fully on-device.\n\nWorks with Claude Desktop, Cursor, Codex, Raycast, VS Code, Warp, Zed, LM Studio, Windsurf, and any MCP-compatible client.\n\n> This repo packages Macuse for agent clients: the **Claude Desktop `.mcpb` installer** and the **agent plugin** for Claude Code and Codex. The macOS app itself and the full docs live at [macuse.app](https://macuse.app).\n\n| You use | Install this | Get |\n| --- | --- | --- |\n| Claude Code, Codex | [Agent plugin](#install-as-an-agent-plugin) | MCP tools **+ skills** |\n| Claude Desktop | [`.mcpb` bundle](#install-for-claude-desktop) | MCP tools |\n| Cursor, Raycast, VS Code, Zed, … | [Direct command](#use-with-other-mcp-clients) | MCP tools |\n\nAll three connect to the same local server. The plugin additionally installs\nskills — instructions that teach the agent how to use the tools correctly\ninstead of discovering the parameter shapes by trial and error.\n\n## What Macuse Does\n\nTwo complementary ways for AI to work with your Mac. Everything runs locally — your data never leaves your device.\n\n### Native App Integrations\n\nYour AI reads and writes directly to macOS apps through natural conversation.\n\n| Toolbox             | What you can ask                                                               |\n| ------------------- | ------------------------------------------------------------------------------ |\n| **Calendar**        | \"Schedule a meeting next Tuesday at 3pm\", find free time, manage events        |\n| **Mail**            | \"Draft a reply to this email\", search inbox, organize messages                 |\n| **Notes**           | \"Find notes mentioning the Q2 launch\", capture ideas, append to notes          |\n| **Reminders**       | Create tasks with due dates and priorities, mark complete, search across lists |\n| **Messages**        | Read and send iMessages, search conversations                                  |\n| **Stickies**        | Search, read, and create sticky notes in Apple Stickies                        |\n| **Contacts**        | Look up by name, email, phone, or company                                      |\n| **Maps & Location** | Place search, directions, travel time, current location                        |\n| **Shortcuts**       | Browse installed Shortcuts and run them with optional input                    |\n\n### Computer Use on macOS\n\nSee 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.\n\n- Click any element, type text, navigate menus, drive any app\n- Fill out web forms, operate enterprise software, automate APIs that don't exist\n- Runs in the background — your cursor and active window stay untouched while AI works in another app\n\n## Install as an Agent Plugin\n\nFor **Claude Code** and **Codex**. Bundles the MCP server with three skills, so\nthe agent knows the workflows, parameter formats, and permission-error recovery\npaths up front.\n\n1. **Install Macuse:** download from [macuse.app/download](https://macuse.app/download/), drag `Macuse.app` to `/Applications`, and launch it once\n2. **Add the marketplace and install:**\n\n   **Claude Code**\n\n   ```shell\n   /plugin marketplace add macuse-app/macuse-mcp\n   /plugin install macuse@macuse-plugins\n   ```\n\n   **Codex**\n\n   ```shell\n   codex plugin marketplace add macuse-app/macuse-mcp\n   codex plugin add macuse@macuse-plugins\n   ```\n\n3. **Approve OAuth:** on the first tool call, approve the authorization prompt in the Macuse window\n\nRestart the session (or run `/reload-plugins` in Claude Code) if tools do not\nappear immediately. Set `MACUSE_BINARY` if the app is not in `/Applications`.\n\n### Skills Included\n\n| Skill | Covers |\n| --- | --- |\n| `macuse-setup` | Install, connect a client, grant macOS permissions, diagnose a broken setup |\n| `macuse-apps` | Calendar, Mail, Reminders, Notes, Messages, Location — routing, parameter shapes, workflow ordering |\n| `macuse-computer-use` | Driving any Mac app's GUI — inspect/act/verify loop, element targeting, error recovery |\n\nThe agent loads a skill only when the task calls for it. Details live in\n[`plugins/macuse/README.md`](plugins/macuse/README.md).\n\n> **Codex users:** write operations currently fail because Codex auto-declines\n> consent prompts from third-party MCP servers\n> ([openai/codex#18896](https://github.com/openai/codex/issues/18896)). Reads\n> work normally.\n\n## Install for Claude Desktop\n\nClaude 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](#use-with-other-mcp-clients) below.\n\n1. **Install Macuse:**\n   - Download from [macuse.app/download](https://macuse.app/download/)\n   - Drag `Macuse.app` to `/Applications` and launch it\n   - Grant the permissions the app prompts for\n2. **Install the bundle:** download `macuse.mcpb` from [Releases](https://github.com/macuse-app/macuse-mcp/releases) and double-click to open in Claude Desktop\n3. **Approve OAuth:** approve the authorization prompt that pops up — connection done\n\nTo uninstall, remove the entry from Claude Desktop settings.\n\n## Use With Other MCP Clients\n\nFor 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:\n\n```json\n{\n  \"mcpServers\": {\n    \"macuse\": {\n      \"command\": \"/Applications/Macuse.app/Contents/MacOS/macuse\",\n      \"args\": [\"mcp\"]\n    }\n  }\n}\n```\n\nPer-client setup guides: [macuse.app/docs/clients](https://macuse.app/docs/clients/).\n\n## Privacy & Permissions\n\n- **Local-only.** All processing stays on your Mac. No cloud, no telemetry of your content.\n- **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.\n- **Per-client OAuth.** Each MCP client gets its own authorization, manageable in Macuse settings.\n\n## How This Works\n\nEvery install path is a thin shim over the same thing: `macuse mcp`, the CLI\nbuilt into the Macuse macOS app. All MCP protocol handling, OAuth, permissions,\nand reconnection live inside the app.\n\n- The **`.mcpb` bundle** is a ~130 LOC Node stdio wrapper that spawns `macuse mcp` and forwards JSON-RPC over stdin/stdout. It exists solely because Claude Desktop doesn't yet support `http://` remote connectors directly.\n- The **plugin** skips Node entirely — a shell launcher execs the same binary, and adds the skills on top.\n\nOverride the binary path with the `MACUSE_BINARY` environment variable\n(configurable in the Claude Desktop bundle UI). Default:\n`/Applications/Macuse.app/Contents/MacOS/macuse`.\n\n## Repo Layout\n\n```\n.claude-plugin/marketplace.json   Claude Code marketplace catalog\n.agents/plugins/marketplace.json  Codex marketplace catalog\nplugins/macuse/                   The plugin — manifests, launcher, skills\nsrc/, bin/                        Node stdio wrapper for the .mcpb bundle\nmanifest.json                     .mcpb bundle manifest (Claude Desktop)\nserver.json                       MCP Registry entry\n```\n\nBoth marketplaces point at `plugins/macuse` in this repo, so one push updates\nevery channel. Version strings across `package.json`, `manifest.json`, and both\nplugin manifests are synced at release time by\n`scripts/sync-manifest-version.js`.\n\nValidate plugin changes before pushing:\n\n```shell\nclaude plugin validate ./plugins/macuse --strict   # plugin manifest\nclaude plugin validate . --strict                  # marketplace catalog\n```\n\n## Requirements\n\n- macOS 13.0 (Ventura) or later — Apple Silicon or Intel\n- [Macuse](https://macuse.app) macOS app installed\n- Node 20.8.1+ for the `.mcpb` bundle only (bundled by Claude Desktop's runtime); the plugin has no Node dependency\n\n## Links\n\n- Website: [macuse.app](https://macuse.app/)\n- Download: [macuse.app/download](https://macuse.app/download/)\n- Docs: [macuse.app/docs](https://macuse.app/docs/)\n- Pricing: [macuse.app/pricing](https://macuse.app/pricing) — free tier with daily limits, or one-time Lifetime\n- MCP spec: [modelcontextprotocol.io](https://modelcontextprotocol.io/)\n\n## License\n\nThis MCPB bundle is MIT-licensed. The Macuse macOS application is a separate commercial product — see [macuse.app](https://macuse.app) for details.\n",
  "bytes": 8633,
  "sha": "e0c35ec4c8e9f3a9633de026c92663ab968a10244563060c8b5cb6dcf901c764",
  "repo_slug": "macuse-app/macuse-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_macuse_app_macuse_9978c73d/readme"
}