Raycast Extension
BusyCal's Raycast extension brings your calendars, events, and tasks into Raycast so you can create, search, and manage calendar items without leaving the keyboard.
The extension connects to BusyCal through the same local automation engine used by AppleScript and the Claude Desktop extension. All data stays on your Mac — nothing is sent to external servers.
The Raycast extension requires BusyCal 2026.1.3 (in beta) or later.
Requirements
The first time you use a BusyCal command, macOS will ask you to grant Raycast permission to control BusyCal via Automation. Click OK to allow it.
Installing the Extension
The BusyCal extension will soon be available in the Raycast Store, subject to Raycast's approval. Once approved, you can install it by searching for "BusyCal" in the Raycast Store.
Commands
Search BusyCal Items
Search your local events and tasks by keyword. Select a result to jump to it in BusyCal.
Open Raycast and type "Search BusyCal Items", then enter your search term.
Upcoming BusyCal Items
Browse your upcoming events and tasks in a list. The number of days to look ahead is configurable in the extension preferences (default: 7 days).
Open Raycast and type "Upcoming BusyCal Items".
Add BusyCal Event
Create a new event using a structured form with fields for title, start and end dates, calendar, location, and notes.
Open Raycast and type "Add BusyCal Event".
Add BusyCal Task
Create a new task using a structured form with fields for title, optional due date, calendar, and notes.
Open Raycast and type "Add BusyCal Task".
Quickly Add BusyCal Event
Create an event using natural language — type the event details in a single line and press Enter. Raycast returns immediately so you can keep working.
Open Raycast and type "Quickly Add BusyCal Event", then enter something like:
Lunch with Sam tomorrow at 1pm /Work
Use /CalendarName at the end to specify which calendar to use.
Quickly Add BusyCal Task
Create a task using natural language — same quick entry style as events.
Open Raycast and type "Quickly Add BusyCal Task", then enter something like:
Finish expense report Friday /Personal
Find Next Available Time
Find the next free time slot in your schedule. You can copy the slot, open it in BusyCal, or create an event directly in that slot.
Open Raycast and type "Find Next Available Time".
Preferences
You can configure the extension in Raycast's extension settings (Raycast > Settings > Extensions > BusyCal):
| Preference | Description | Default |
|---|---|---|
| Hide Raycast after quick add | Dismiss Raycast immediately after a quick add command. | On |
| Upcoming horizon | How many days to look ahead in the Upcoming view. | 7 days |
| Include tasks in upcoming | Show tasks alongside events in the Upcoming view. | On |
| Minimum slot duration | Minimum free slot length for Find Next Available Time (15, 30, 45, 60, or 90 minutes). | 30 minutes |
| Respect working hours | Only find free time within your configured working hours. | On |
Working hours are configured in BusyCal > Settings > General (Day starts at, Day ends at, and working days). The extension uses these settings when checking availability.