Integration With Other Apps
AppleScript
You can send a sentence to Fantastical using AppleScript. Here's an example script to create the event "Wake up at 8am."
tell application "Fantastical"
parse sentence "Wake up at 8am"
end tell
For full automation, you can have Fantastical create new events and tasks with no interaction by using the add immediately parameter:
tell application "Fantastical"
parse sentence "Wake up at 8am" with add immediately
end tell
URL Handler
Other apps can use the URL handler to send sentences to the main Fantastical app, or the Fantastical Mini Window.
parse
Parses a string of text in Fantastical:
x-fantastical://parse?sentence=Lunch%20with%20Ana%20tomorrow%20at%20noon
All parameter values must be URL-encoded.
Optional parameters
sentence: The natural-language text to parse (title, date, time, and other details detected by the parser).
x-fantastical://parse?sentence=Lunch%20with%20Ana%20tomorrow%20at%20noon
notes: Adds a note to the new item.
x-fantastical://parse?sentence=Gym%20tonight%207pm¬es=leg%20day
add: Add the item immediately, without interaction.
x-fantastical://parse?sentence=Standup%20Friday%209am&add=1
You can also specify individual parameters:
- title: Set the title explicitly, instead of passing a sentence.
- location
- url
- calendarName
- start: Set the start date or time. Accepts
yyyy-MM-dd HH:mm,yyyy-MM-dd(date only), or natural-language text. - end: Set the end date or time, in the same formats as start.
- allDay: Set to
1to create an all-day item. - availability: Set the event's availability. One of
free,busy,tentative,outofoffice,workingelsewhere. - private: Set to
1to mark the event as private. - attendees: Add invitees as a comma-separated list of email addresses. The
Name <email>form is also accepted. - structured[title], structured[address], structured[lat], structured[long]: Attach a structured location. Provide a title, address, latitude, and longitude.
- task: Set to
1to create a task instead of an event. - due: Set a task's due date, in the same formats as start.
show
Open a Fantastical view:
Main app: x-fantastical://show/calendar
Mini Window: x-fantastical-mini://show/mini
Select a calendar set
x-fantastical://show/set?name=CalendarSetName
Reveal a specific date
x-fantastical://date/yyyy-MM-dd
search
x-fantastical://search?s=dentist
To activate the options in the Mini Window, use x-fantastical-mini instead of x-fantastical.
