Fantastical

Fantastical is a calendar and tasks app you won't be able to live without. Winner of the Apple Design Award and Mac App of the Year, Fantastical combines a beautiful interface with powerful features like natural language event creation, task management, and integration with Google Calendar, iCloud, Exchange, and more. Protocol Launcher allows you to generate deep links to create events and navigate dates in Fantastical.

Usage

There are two ways to use this library:

• On-Demand import from subpaths enables tree-shaking and keeps bundles small.
• Full Import from the root package is convenient but includes all app modules.

Pick On-Demand for production builds; Full Import is fine for quick scripts or demos.

Select Installation Method

On-Demand

Recommended. Optimized for production.

Full Import

Convenient. Good for quick scripts.

Parse (Create Event)

Create a new event in Fantastical using natural language input:

On-Demand

import { parse } from 'protocol-launcher/fantastical'

const url = parse({
  sentence: 'Lunch with John at 12pm tomorrow',
})

Create Event with Natural Language

Create a new event using structured parameters:

On-Demand

import { parse } from 'protocol-launcher/fantastical'

const url = parse({
  title: 'Team Meeting',
  start: '2026-03-30 10:00',
  end: '2026-03-30 11:00',
  location: 'Conference Room A',
  notes: 'Discuss Q2 roadmap',
})

Create Event with Structured Params

Create a reminder instead of an event:

On-Demand

import { parse } from 'protocol-launcher/fantastical'

const url = parse({
  title: 'Call Sarah',
  reminder: true,
  due: '2026-03-30 15:00',
  notes: 'Discuss project update',
})

Create Reminder

Show (Navigate to Date)

Jump to today's date in Fantastical:

On-Demand

import { show } from 'protocol-launcher/fantastical'

const url = show({
  date: 'today',
})

Show Today

Jump to a specific date:

On-Demand

import { show } from 'protocol-launcher/fantastical'

const url = show({
  date: '2026-03-30',
})

Show Specific Date

Jump to a date using natural language:

On-Demand

import { show } from 'protocol-launcher/fantastical'

const url = show({
  date: 'next monday',
})

Show Natural Language Date