Help Center

Find answers to common questions and learn how to get the most out of Orchard

Browse the Documentation Step-by-step guides for setup, every app integration, and the CLI

Getting Started

How do I install Orchard?

1. Download Orchard from our website

2. Open the downloaded .dmg file

3. Drag Orchard to your Applications folder

4. Launch Orchard and sign in with your account

5. Grant necessary permissions when prompted

6. Connect your AI tool — Orchard's setup guide installs the Skill into Claude Code, ChatGPT Desktop, and more with one click (MCP clients use orchard mcp instead)

Can I use Orchard from the terminal?

Yes — Orchard ships with a full command-line tool. Click Install CLI Tool in Orchard's settings, then use orchard directly in your terminal or scripts:

  • orchard mail read --type unread --limit 5
  • orchard weather get --location "Tokyo"
  • orchard music control --action play

Apple-app commands support --json for structured output, and Orchard 0.6.2 adds orchard status, orchard features, and orchard doctor for setup and diagnostics.

What AI assistants does Orchard support?

Any AI assistant that supports Agent Skills or MCP works with Orchard. It connects through three channels: an installable Agent Skill (the recommended path), a terminal CLI, and a local MCP server. Popular examples:

  • Claude Code - Anthropic's agentic coding tool, installs the Orchard Skill in one click
  • ChatGPT Desktop - OpenAI's desktop app with the Codex agent built in, via Agent Skills
  • Claude Desktop - Official Anthropic client, opens the .skill package directly
  • Craft Agents - Craft's open-source agent interface, via Agent Skills or MCP
  • Cursor - via Agent Skills or the orchard mcp command
  • Any other MCP client - via the orchard mcp command

Why does Orchard work in Claude Desktop but not in Cowork?

Cowork runs in an isolated sandbox and cannot call the orchard CLI on your Mac directly. Orchard 0.6.2 adds the missing bridge:

  1. Update Orchard to 0.6.2 or later
  2. Import the latest Orchard Skill in Claude Desktop
  3. In Orchard's Use Orchard with Skills screen, click Verify on MCP for Claude Desktop, Cursor & more
  4. Fully quit and reopen Claude Desktop, then start a new Cowork task

The current Skill detects Cowork and uses the Claude Desktop MCP bridge automatically. If Verify fails, click Copy Config and follow the manual configuration steps.

Which macOS apps are supported?

Native Apple app integrations include:

Calendar - Event management
Reminders - Task organization
Notes - Document creation
Mail - Email management
Messages - Messaging control
Maps - Location services
Music - Playback control
Weather - Forecast info
Contacts - Contact management
Clock - Time & timezone tools
Shortcuts - Run your Shortcuts

11 apps, 52 local tools in total. Reminders, Calendar & Clock are free; the rest require Pro.

Account & Billing

Orchard Pricing Plans

How do I manage my devices?

You can manage your authorized devices from your dashboard:

  • View all connected devices
  • Remove devices you no longer use
  • See last active times
  • Authorize new devices

Can I cancel my subscription?

Yes, you can cancel anytime from your dashboard. After cancellation:

  • You'll keep Pro features until your current billing period ends
  • Your account will automatically revert to the Free plan
  • No cancellation fees or penalties

Troubleshooting

Orchard isn't responding to commands

Try these troubleshooting steps:

  • Update Orchard and install any Skill update shown in its setup screen
  • Open Orchard manually if its automatic launch failed
  • Run orchard doctor to check the app connection, Skill installs, and MCP configs without changing anything
  • For Claude Cowork, click Verify on Orchard's MCP row and fully restart Claude Desktop

Permission errors with macOS apps

Orchard needs certain permissions to control macOS apps:

  • Go to System SettingsPrivacy & Security
  • Calendar, Reminders, Contacts, and Location use their matching privacy categories
  • Reading Mail, Messages, or Notes needs Full Disk Access
  • Sending or controlling Mail, Messages, Notes, Music, or Shortcuts needs Automation permission for that app
  • Retry the command after granting access

Can't sign in to my account

If you're having trouble signing in:

  • Check your email and password
  • Try using Magic Link login instead
  • Clear your browser cache if using web login
  • Make sure you're using the correct sign-in method (email, Google, or GitHub)
  • Contact support if the issue persists

Privacy & Security

How does Orchard protect my privacy?

Orchard is built with privacy-first principles:

  • Local processing: All automation happens locally on your Mac
  • Zero data collection: We don't collect your AI conversations or commands
  • No personal data sharing: No personal data from your apps is sent to our servers
  • No network exposure: Orchard runs no HTTP server and opens no network ports — tool calls travel over a local Unix domain socket
  • Open standards: Built on Agent Skills and the open Model Context Protocol (MCP)
  • Read our full Privacy Policy

What data does Orchard store?

We only store minimal data needed for the service:

  • Account information: Email, subscription status
  • Device identifiers: For license management only
  • Anonymized usage statistics: To improve the service
  • No personal content: No files, conversations, or automation commands

Still Need Help?

Can't find what you're looking for? Our support team is here to help.

Contact Support