# macuse

An on-device MCP server that lets your agent read and write Calendar, Mail, Notes, Reminders and Messages, and drive any Mac app.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 46
- Author: macuse-app
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/macuse-app/macuse-mcp
- Updated: 2026-08-03
- HTML: https://affpapa.org/en/nevibecode/mcp/macuse

## What it does

Everything macuse does happens on your Mac. No cloud round-trip, no content telemetry. Through MCP tools the agent works with Calendar, Mail, Notes, Reminders, Messages, Stickies, Contacts, Maps and Shortcuts — booking events, searching mail, creating tasks with due dates. Computer Use covers the rest: clicking elements, typing, walking menus in apps that have no dedicated integration. It runs in the background, so your cursor and active window stay where they are.

Three install paths, one engine. Claude and Codex get a plugin that ships the server plus three skills: `macuse-setup` for install, client connection, macOS permissions and troubleshooting; `macuse-apps` for parameter shapes and call ordering across the built-in apps; `macuse-computer-use` for the inspect/act/verify loop and error recovery. Claude Desktop takes the `.mcpb` bundle. Cursor, Zed, VS Code, Windsurf and similar clients point at the binary themselves — `/Applications/Macuse.app/Contents/MacOS/macuse` with the `mcp` argument. Underneath, all of them call `macuse mcp`, the CLI inside the app, where protocol handling, OAuth, permissions and reconnection live.

Before any of that, download Macuse from macuse.app/download, drag `Macuse.app` into `/Applications` and launch it once. Permissions are granted per app and per client, and the first tool call asks you to approve OAuth in the Macuse window. If the app sits outside `/Applications`, set `MACUSE_BINARY` to its path.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- book a meeting and check for conflicts
- draft a reply to an email in Mail
- add a reminder with a due date and priority
- find notes that mention a project
- drive an app that has no integration

## Example prompts
- Schedule a meeting for next Tuesday at 3pm and check my free time
- Find emails from the vendor in Mail and draft a reply
- Open the app and fill in the form for me

## Similar
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32221

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md