llms.txt
# Macuse
> Give your AI superpowers on macOS. Macuse is a native macOS MCP (Model Context Protocol) server that lets any MCP-compatible AI client — Claude Desktop, Cursor, Raycast, VS Code, Windsurf, and more — control Calendar, Mail, Reminders, Notes, Messages, Contacts, Maps, and Shortcuts, and drive any Mac application through background Computer Use. Macuse retrieves native app data locally and returns requested results to the user's chosen AI client; cloud clients may send that data to their model provider. Macuse collects limited product analytics and error metadata, not native app content.
Key facts:
- Platform: macOS 13.0+ (Apple Silicon and Intel)
- Transports: stdio and Streamable HTTP on 127.0.0.1:35729; Claude Desktop can install the stdio integration as an .mcpb bundle
- Auth: OAuth 2.1 for HTTP transport, plus API keys for clients that cannot complete OAuth
- Languages: English UI and docs
- Plans: Free plan with 100 tool calls per day and one connected client; one-time Lifetime purchase removes those limits
When to use Macuse:
- Use Macuse when a user wants an agent to read or change data in supported native Mac apps, or operate a macOS application through Computer Use.
- Prefer a structured Macuse app tool for Calendar, Mail, Notes, Reminders, Messages, Contacts, Maps, Shortcuts, or Stickies. Use Computer Use only for visual workflows or apps without a structured tool.
- Use the local MCP server only after the user has installed Macuse, connected the current client, and approved the relevant app and macOS permissions.
How an agent should call Macuse:
- Discover tool names and input schemas from the connected MCP server; do not infer them from marketing pages.
- Confirm consequential writes and minimize personal data retrieval. Follow permission and authentication resolution hints instead of bypassing them.
- Do not assume 127.0.0.1 is reachable from a hosted agent. Macuse does not currently advertise a public hosted remote MCP endpoint.
- See the complete agent contract at https://macuse.app/agent-instructions.md.
## Core pages
- [Macuse — Give your AI superpowers on macOS](https://macuse.app): Native macOS MCP server that lets Claude, Cursor, Raycast and any MCP client control Calendar, Mail, Notes, Reminders, plus drive any Mac app via Computer Use.
- [Features](https://macuse.app/features): Full feature matrix: native app integrations, Computer Use, MCP transports, privacy.
- [Computer Use for macOS](https://macuse.app/computer-use): Background-run UI automation: click, type, scroll, and drive any Mac application from any AI client.
- [MCP Server for Mac](https://macuse.app/mcp-server-for-mac): What MCP is, how Macuse exposes Mac apps as MCP tools, and which clients are supported.
- [Pricing](https://macuse.app/pricing): Free trial plus a one-time license. Computer Use, all native apps, all clients included.
- [License Management](https://macuse.app/license): Self-service portal for viewing active Macs and deactivating old license devices.
- [Macuse vs apple-mcp](https://macuse.app/vs/apple-mcp): Comparison: paid signed app with Computer Use and OAuth vs free MIT-licensed Bun-based scripts.
## Documentation
- [Introduction](https://macuse.app/docs): Get started with Macuse MCP server. Install in 2 minutes, connect to Claude, Cursor, or Raycast, and start automating your Mac apps.
### Getting started
- [Installation](https://macuse.app/docs/getting-started/installation): How to install Macuse on your Mac
- [Configuration](https://macuse.app/docs/getting-started/configuration): Configure Macuse with your AI tools
- [Permissions](https://macuse.app/docs/getting-started/permissions): Understanding and granting permissions for Macuse
### Features
- [Features Overview](https://macuse.app/docs/features): Two ways for AI assistants to work with your Mac. Native app integrations, or Computer Use for everything else.
- [App Integrations](https://macuse.app/docs/features/apps): Native, structured access to macOS apps. Calendar, Mail, Notes, Reminders, Messages, Contacts, Stickies, Maps, and Location.
- [Calendar](https://macuse.app/docs/features/apps/calendar): Manage calendar events and check availability
- [Reminders](https://macuse.app/docs/features/apps/reminders): Create and manage reminders and to-do lists
- [Mail](https://macuse.app/docs/features/apps/mail): Search, read, and manage emails
- [Notes](https://macuse.app/docs/features/apps/notes): Create and manage notes in Apple Notes
- [Stickies](https://macuse.app/docs/features/apps/stickies): Read and create sticky notes in Apple Stickies
- [Messages](https://macuse.app/docs/features/apps/messages): Read and send iMessages and SMS
- [Contacts](https://macuse.app/docs/features/apps/contacts): Search and browse your contacts
- [Shortcuts](https://macuse.app/docs/features/apps/shortcuts): Browse, inspect, and run Apple Shortcuts from your AI assistant
- [Location](https://macuse.app/docs/features/apps/location): Get device location using Location Services
- [Maps](https://macuse.app/docs/features/apps/maps): Search places and get directions via Apple Maps
- [Computer Use](https://macuse.app/docs/features/computer-use): Let any AI client see and control any Mac app. Computer Use that runs on-device.
### Clients
- [Client Configuration](https://macuse.app/docs/clients): Configure Macuse with your favorite AI tools
- [AnythingLLM](https://macuse.app/docs/clients/anythingllm): Configure Macuse with AnythingLLM
- [BoltAI](https://macuse.app/docs/clients/boltai): Configure Macuse with BoltAI
- [ChatGPT](https://macuse.app/docs/clients/chatgpt): Configure Macuse with Codex on your Mac, or with ChatGPT on the web
- [ChatWise](https://macuse.app/docs/clients/chatwise): Configure Macuse with ChatWise
- [Cherry Studio](https://macuse.app/docs/clients/cherry-studio): Configure Macuse with Cherry Studio
- [Claude](https://macuse.app/docs/clients/claude): Configure Macuse with Claude Desktop or Claude.ai
- [Claude Code](https://macuse.app/docs/clients/claude-code): Configure Macuse with Claude Code
- [Cline](https://macuse.app/docs/clients/cline): Configure Macuse with Cline
- [Cursor](https://macuse.app/docs/clients/cursor): Configure Macuse with Cursor
- [Gemini CLI](https://macuse.app/docs/clients/gemini-cli): Configure Macuse with Gemini CLI
- [GitHub Copilot CLI](https://macuse.app/docs/clients/github-copilot-cli): Configure Macuse with GitHub Copilot CLI
- [goose](https://macuse.app/docs/clients/goose): Configure Macuse with goose
- [Grok](https://macuse.app/docs/clients/grok): Configure Macuse with Grok on the web or with Grok Bot
- [JetBrains](https://macuse.app/docs/clients/jetbrains): Configure Macuse with JetBrains IDEs
- [Kiro](https://macuse.app/docs/clients/kiro): Configure Macuse with Kiro
- [LM Studio](https://macuse.app/docs/clients/lmstudio): Configure Macuse with LM Studio
- [Msty Studio](https://macuse.app/docs/clients/msty): Configure Macuse with Msty Studio
- [OpenCode](https://macuse.app/docs/clients/opencode): Configure Macuse with OpenCode
- [Perplexity](https://macuse.app/docs/clients/perplexity): Configure Macuse as a local Perplexity connector
- [Raycast](https://macuse.app/docs/clients/raycast): Configure Macuse with Raycast
- [Visual Studio Code](https://macuse.app/docs/clients/vscode): Configure Macuse with Visual Studio Code
- [Warp](https://macuse.app/docs/clients/warp): Configure Macuse with Warp
- [Zed](https://macuse.app/docs/clients/zed): Configure Macuse with Zed
### Configuration
- [stdio Transport](https://macuse.app/docs/configuration/stdio): Manual configuration using stdio transport
- [HTTP Transport](https://macuse.app/docs/configuration/streamable-http): Connect to Macuse over HTTP
- [API Keys](https://macuse.app/docs/configuration/api-keys): Authenticate non-OAuth AI apps with API keys
- [Remote Access](https://macuse.app/docs/configuration/remote-access): Give Macuse a public HTTPS endpoint so hosted AI clients can reach it
- [Low Context Mode](https://macuse.app/docs/configuration/low-context-mode): Optimize Macuse for AI apps with limited context windows
- [Interactive Tools (MCP Apps)](https://macuse.app/docs/configuration/interactive-tools): Render supported Macuse results as interactive UI in compatible MCP clients
- [Plans and Limits](https://macuse.app/docs/configuration/plans-and-limits): Understand Macuse plan limits for tool calls and connected clients
### Troubleshooting
- [Troubleshooting](https://macuse.app/docs/troubleshooting): Solutions for the most common Macuse issues — permissions and MCP client connectivity.
- [Permission Issues](https://macuse.app/docs/troubleshooting/permissions): Fix denied Full Disk Access, Automation, and Accessibility permissions on macOS.
- [MCP Client Issues](https://macuse.app/docs/troubleshooting/mcp-clients): Reconnect Claude Desktop, Codex, and other MCP clients when Macuse tools stop appearing, and configure remote access from Claude.ai web or tunneled clients.
## Integrations
- [Claude Desktop integration](https://macuse.app/integrations/claude-desktop): Anthropic's official AI assistant for macOS
- [Claude Code integration](https://macuse.app/integrations/claude-code): Anthropic's coding agent in your terminal
- [Cursor integration](https://macuse.app/integrations/cursor): AI-first code editor
- [Raycast integration](https://macuse.app/integrations/raycast): Productivity launcher for macOS
- [VS Code integration](https://macuse.app/integrations/vscode): Microsoft's popular code editor
- [goose integration](https://macuse.app/integrations/goose): Open-source AI agent by Block
- [AnythingLLM integration](https://macuse.app/integrations/anythingllm): All-in-one AI desktop app
- [ChatWise integration](https://macuse.app/integrations/chatwise): Native AI chat for Mac
- [LM Studio integration](https://macuse.app/integrations/lmstudio): Run local LLMs on your Mac
- [Msty Studio integration](https://macuse.app/integrations/msty): AI chat with local & cloud models
- [Perplexity integration](https://macuse.app/integrations/perplexity): AI-powered answer engine
- [Cherry Studio integration](https://macuse.app/integrations/cherry-studio): Cross-platform AI desktop client
- [Warp integration](https://macuse.app/integrations/warp): AI-powered terminal for macOS
- [JetBrains integration](https://macuse.app/integrations/jetbrains): Professional IDE family with AI Assistant
- [Codex integration](https://macuse.app/integrations/codex): OpenAI's coding agent — CLI and macOS app
- [Grok integration](https://macuse.app/integrations/grok): xAI's assistant, on the web and in Grok Bot
## Developer and agent resources
- [Macuse Developer Resources](https://macuse.app/developers): OpenAPI, MCP, authentication, webhook boundaries, and agent integration guidance.
- [Macuse Authentication](https://macuse.app/developers/authentication): OAuth, API-key, license credential, public endpoint, and Stripe signature boundaries.
- [Macuse MCP Server](https://macuse.app/developers/mcp): When to use Macuse MCP, local stdio and Streamable HTTP transports, and Registry packaging.
- [Macuse Webhook Status](https://macuse.app/developers/webhooks): The current webhook product boundary and the internal Stripe receiver.
- [Macuse OpenAPI 3.1 document](https://macuse.app/openapi.json): Machine-readable HTTP API contract.
- [Macuse MCP Registry manifest](https://macuse.app/server.json): Machine-readable Registry package and stdio transport metadata.
- [Macuse Agent Instructions](https://macuse.app/agent-instructions.md): Specific when-to-use, connection, permission, and safe tool-calling guidance.
## Blog
- [How to Read and Send Email from Claude Desktop](https://macuse.app/blog/claude-desktop-apple-mail): Set up Apple Mail access in Claude Desktop with Macuse. Search, read, reply, forward, and compose emails without leaving the chat.
- [Manage Your Calendar from Cursor with MCP](https://macuse.app/blog/cursor-calendar-mcp): Connect Apple Calendar to Cursor through Macuse. Create events, find open slots, and reschedule meetings without leaving your editor.
- [See Your Emails and Events Right in the Chat](https://macuse.app/blog/mcp-apps-interactive-ui-cards): Macuse 1.4 brings MCP Apps to your AI chat. See emails, calendar events, notes, and reminders as visual cards. Click to open directly in native Mac apps.
- [Your AI Agent Doesn't Need 5 Tools to Control Your Mac](https://macuse.app/blog/one-server-for-all-mac-apps): A technical look at consolidating OpenClaw's fragmented macOS skills into a single MCP server with native API access to Calendar, Mail, Notes, and more.
- [Apple MCP Servers in 2026: Updated Comparison & Honest Picks](https://macuse.app/blog/state-of-apple-mcp-servers-2026): An updated comparison of Apple MCP servers for macOS: native app coverage, Computer Use, setup, maintenance, privacy, and honest picks for 2026.
- [Capture Ideas Before They Disappear](https://macuse.app/blog/stickies-quick-capture): Macuse now integrates with Apple Stickies. Capture thoughts instantly, color-code by priority, and keep ideas visible on your screen. No app switching required.
## Optional
- [Changelog](https://macuse.app/changelog): Release history.
- [Blog](https://macuse.app/blog): Product updates, deep dives, and integration guides.
- [Integrations Hub](https://macuse.app/integrations): Index of every supported AI client.
- [About Macuse](https://macuse.app/about): What Macuse does, how the local MCP architecture works, and the product principles behind it.
- [Contact Macuse](https://macuse.app/contact): Support, privacy, security, billing, and developer contact guidance.
- [Privacy Policy](https://macuse.app/privacy): How native app data, AI clients, analytics, and error metadata are handled.
- [Terms of Service](https://macuse.app/terms): Standard SaaS terms for the Macuse desktop app.
