Apple MCP Server for macOS

One local MCP server, 11 Apple apps, 52 tools — works with Claude, ChatGPT, Cursor, Codex, Raycast AI, Gemini CLI, GitHub Copilot and any MCP client.

What the Orchard MCP server does

orchard mcp is a local stdio MCP server that ships inside Orchard for macOS. Your MCP client starts it directly on your Mac; there is no HTTP server, no listening network port, and no cloud in between. Every tool call travels over a local Unix domain socket to the running Orchard.app, which is the only process that actually talks to your Apple apps.

Orchard reaches your Apple apps through native frameworks instead of driving them with AppleScript: Reminders and Calendar use EventKit, Contacts uses the Contacts framework, Maps uses MapKit and CoreLocation, Weather uses WeatherKit, and Apple Music uses MusicKit. Mail and Messages read your local databases directly and send through Mail.app and Messages.app; Shortcuts runs through the shortcuts command.

11 Apple apps, 52 MCP tools

Reminders, Calendar, and Clock are free on every plan with no usage limits. The remaining 8 apps are Pro. Every card links to that app's full tool reference.

52 tools across all 11 apps — the same set the Orchard Skill and the orchard CLI use.

Works with any MCP client

Any client that speaks the Model Context Protocol over stdio can launch orchard mcp. If it doesn't see yours below, and it supports MCP, it already works the same way.

Client How it connects Guide
Claude Desktop & Cowork Import the Orchard Skill; Cowork’s sandbox routes through Claude Desktop’s MCP-configured orchard entry automatically. Claude Desktop guide
Claude Code Install the Orchard Agent Skill in one click (recommended); orchard mcp also works if you prefer MCP. Claude Code guide
ChatGPT Desktop Via Agent Skills where supported; otherwise add orchard mcp as a stdio MCP server. ChatGPT Desktop notes
Codex Reads the shared Agent Skills path directly — the same Local Agents install covers it. Codex guide
Cursor Add orchard mcp as a stdio MCP server (Copy Config button, or edit ~/.cursor/mcp.json manually). MCP setup guide
Raycast AI Add orchard mcp as a stdio MCP server. MCP setup guide
Gemini CLI Add orchard mcp as a stdio MCP server. MCP setup guide
GitHub Copilot Add orchard mcp as a stdio MCP server. MCP setup guide
Windsurf / Cline / other MCP clients Add orchard mcp as a stdio MCP server. MCP setup guide

Set up the Apple MCP server in 5 minutes

  1. Download and install Orchard (macOS 13 or later). Open the .dmg, drag Orchard to Applications, launch it, and sign in.
  2. Grant permissions once, on first use. The first time a tool touches a new Apple app, macOS shows its standard permission prompt. Only Orchard.app ever holds a permission — the CLI and MCP layer never do.
  3. Add orchard mcp to your client's MCP configuration. Orchard's Copy Config button on the app's setup screen copies this JSON to your clipboard; paste it into your client's MCP config file.
{
  "mcpServers": {
    "orchard": {
      "command": "/usr/local/bin/orchard",
      "args": ["mcp"]
    }
  }
}

Full walkthrough, including automatic configuration for Claude Desktop and Cursor, is in the MCP setup guide.

Why a native Apple MCP server instead of AppleScript

  • Native frameworks like EventKit, Contacts, MapKit, WeatherKit, and MusicKit are faster and more reliable than driving apps through AppleScript.
  • One server covers all 11 Apple apps, instead of maintaining a separate script or integration for each one.
  • A single signed app holds every macOS permission grant under its own authorization model; the CLI and the MCP layer never hold a permission themselves.
  • The MCP server is one of three channels to the same tools — there's also an Agent Skill and the orchard CLI for clients that prefer those instead.

Private by design

Orchard runs no HTTP server and opens no network port. Tool calls stay on a local Unix socket between your MCP client and Orchard.app, and nothing about your reminders, calendar, mail, or messages is proxied through an Orchard server, because there isn't one. Full details are in the Privacy Architecture guide.

Frequently asked questions

Is the Orchard MCP server free?

Reminders, Calendar, and Clock are free on the Orchard MCP server with no usage limits. The other 8 apps — Mail, Notes, Messages, Contacts, Maps, Apple Music, Weather, and Shortcuts — require Pro. A one-time Lifetime license is $39.99. See Free vs Pro for the full breakdown.

Does it work with ChatGPT?

ChatGPT Desktop can use the Orchard Skill if it supports the Agent Skills convention, the same way Claude Code and Codex do. Orchard has no dedicated ChatGPT Desktop installer, so if Agent Skills isn't available yet, connect it through the Orchard MCP server (orchard mcp) instead — see the MCP setup guide.

Do I need an API key?

No. Weather uses Apple’s own WeatherKit data and Maps uses MapKit and CoreLocation — both work with no API key and no server URL to manage, the same way the built-in Weather and Maps apps do.

Which macOS permissions does it need?

It depends on which apps you enable: Reminders, Calendar, and Contacts each use their own privacy-category permission; Weather and Maps need Location only when a call omits explicit coordinates; and Mail, Messages, and Notes need Full Disk Access to read content plus Automation permission to send or control that app. Clock needs no permission at all. See the Permissions Guide for the complete breakdown.

Can I run it over SSH or on a headless Mac?

Yes. orchard mcp doesn’t listen on any network port, so there’s no way to connect to it directly from another machine — instead, have your MCP client launch orchard mcp on the remote Mac over SSH, for example with "command": "ssh", "args": ["user@mac-hostname", "/usr/local/bin/orchard", "mcp"]. SSH carries the connection between your local MCP client and the remote Orchard; Orchard itself still never opens a network port. See Remote access over SSH for the full example.

No HTTP server · No open ports · Local Unix socket · macOS 13 or later