Skip to main content

Apple Calendar

Connect Toby to Calendar.app on your Mac to search, create, and update events.

The Apple Calendar plugin ships with Toby.app under ~/.toby/plugins/.

Platform

macOS only. Calendar tools require Calendar.app on a Mac.

Prerequisites​

  • macOS with Calendar.app and at least one calendar (iCloud, Exchange, Google via CalDAV, etc.)
  • Toby.app installed and launched (the plugin auto-launches it when not running)
  • Calendar permission granted to Toby.app in System Settings → Privacy & Security → Calendars

Configure​

Open Toby.app → Settings → Integrations → Apple Calendar. Optional Notes are for your own reference only. Save.

Connect​

Click Connect on the Apple Calendar detail page. Toby runs a Calendar.app health check and stores a connected flag.

The plugin delegates all calendar operations to Toby.app's native API server, which uses EventKit to access Calendar.app. When Toby.app is not running, the plugin auto-launches it in the background. Calendar permission is granted to Toby.app, not the plugin itself.

Verify​

Return to Settings → Integrations. Apple Calendar should show as connected. The first time you use calendar tools, macOS may prompt you to grant Calendar access to Toby.app.

Home​

When Apple Calendar is connected (and set as the default calendar provider under Settings → Default Providers, if you use more than one calendar integration), the Home Upcoming card shows events for the next 7 days. You can hide or show that card under Settings → Home.

Disconnect​

Select Apple Calendar in Settings → Integrations and click Disconnect.

Example chat prompts​

  • “What meetings do I have tomorrow between 9am and 5pm?”
  • “Create a 30-minute focus block called Deep work tomorrow at 10am on my Work calendar.”

Tips​

  • Use exact calendar names from your calendar list when filtering.
  • Event UIDs are Calendar.app string identifiers returned by search or create tools.