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

Every command supports --json for structured output, so it plugs straight into scripts and agent workflows.

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

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:

  • Make sure Orchard is running in the background
  • Confirm the Orchard Skill is installed in your agent (Claude Code, ChatGPT Desktop, Cursor, or Claude Desktop)
  • If using Cursor or another MCP client, verify orchard mcp is configured correctly
  • Restart both Orchard and your AI assistant
  • Check for app updates

Permission errors with macOS apps

Orchard needs certain permissions to control macOS apps:

  • Go to System SettingsPrivacy & Security
  • Check Accessibility permissions for Orchard
  • Check Automation permissions for specific apps
  • Restart Orchard after granting permissions

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