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 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.

You use	Install this	Get
Claude Code, Codex	Agent plugin	MCP tools + skills
Claude Desktop	.mcpb bundle	MCP tools
Cursor, Raycast, VS Code, Zed, …	Direct command	MCP tools

All three connect to the same local server. The plugin additionally installs skills — instructions that teach the agent how to use the tools correctly instead of discovering the parameter shapes by trial and error.

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 as an Agent Plugin

For Claude Code and Codex. Bundles the MCP server with three skills, so the agent knows the workflows, parameter formats, and permission-error recovery paths up front.

1. Install Macuse: download from macuse.app/download, drag Macuse.app to /Applications, and launch it once

2. Add the marketplace and install:

   Claude Code

   /plugin marketplace add macuse-app/macuse-mcp
   /plugin install macuse@macuse-plugins
   

   Codex

   codex plugin marketplace add macuse-app/macuse-mcp
   codex plugin add macuse@macuse-plugins
   

3. Approve OAuth: on the first tool call, approve the authorization prompt in the Macuse window

Restart the session (or run /reload-plugins in Claude Code) if tools do not appear immediately. Set MACUSE_BINARY if the app is not in /Applications.

Skills Included