# Cachet Calendar

> Premium scheduling for executives, advisors, and consultants. Part of the Cachet suite
> (Cachet Card, Cachet Contacts, Cachet Calendar). Version 2.1.0.

## What it does today (verifiable at booking time)
- Public booking pages at /b/<handle>. An invitee books with no account (zero friction).
- Google Calendar connect (OAuth, scopes: calendar.events + calendar.freebusy). Free/busy is
  read LIVE at booking time (no reliance on lossy calendar webhooks), so a confirmed slot is
  never double-booked.
- Real events created on the host's Google Calendar with both parties as attendees and a Google
  Meet link; Google emails both parties the invite, so the meeting lands on both calendars.
- Timezone honesty: every time is shown and confirmed in BOTH the host's zone and the invitee's
  zone. The invitee's zone is auto-detected; the underlying instant is one UTC value, so the two
  displayed times are provably the same moment.
- Private reschedule/cancel link on every booking (capability-key gated, no login).
- Configurable meeting types (name, length, buffer) and weekly availability per host.
- Host-facing "Your meetings" list on the dashboard: every booking (upcoming soonest-first, past
  most-recent-first), guest name, meeting type, time in the host's own zone; a cancelled booking
  stays visible with a label rather than disappearing.
- Custom invitee questions, defined per meeting type (add/reorder/remove, each required or
  optional). A missing required answer is rejected before any calendar event is created; every
  answer appears in the host's confirmation email and on the calendar event.

## The calendar client (v2, shipped)
- A full calendar client IN THE BROWSER at /calendar: day, week, and month views over the host's
  real Google calendars. No install, any operating system with a browser.
- Every calendar the host grants is listed with its own colour and can be shown or hidden; the
  choice is saved, on the free tier, with no upgrade prompt.
- Create, edit, drag to move, drag to resize, and delete events. A drag writes ONLY the times, so
  moving a meeting never overwrites its description, attendees, or colour.
- Repeating events via RFC 5545 RRULE (daily, weekly, every 2 weeks, monthly, yearly), described
  back in plain English with the next occurrences previewed before saving. Recurrence is generated
  in the event's own timezone, so a 9am weekly meeting is still 9am after a daylight-saving change.
- Sync reconciliation, not webhook trust: the client mirrors each calendar using Google's own
  incremental sync tokens, re-baselines automatically when a token expires or its window runs out,
  and STATES when it last synced (and which calendar failed, if one did) rather than quietly
  showing a stale view.
- Natural-language entry powered by a language model, not a regular-expression parser. Its stated
  bar is the failure modes competitors' own reviewers report: it keeps the title intact, and when
  a phrase is vague ("in the evening") it ASKS for the time instead of silently assigning one.
  When the model is unavailable a simple pattern reader takes over and the interface says so.

## Standing instructions (v2.1, shipped)
- Say a scheduling rule once, in plain English ("keep Friday afternoons clear", "no meetings
  before 9am", "nothing after 6pm on weekdays", "keep meetings under 90 minutes"), and it keeps
  applying. Each rule is restated back in plain words so you can see it was understood correctly.
- Two halves, and the difference is deliberate:
  PREVENT, automatic: a rule becomes real busy time on the booking page, so nobody can book into
  a window you protected, and a meeting type longer than your cap is not offered at all. This is
  enforced where slots are DISPLAYED and again where a booking is CONFIRMED, so a direct request
  cannot walk through it. No message is sent to anyone to make this true.
  SURFACE, never automatic: meetings already on your calendar that break a rule are listed for
  you to handle. Cachet does not decline them and does not write to the organizer. Declining
  someone else's meeting is an outward act and stays your decision.
- Only Microsoft Copilot's Calendar Instructions reaches this tier elsewhere, it is new, and it
  needs an M365 seat. No personal calendar client has it. None of them can do the PREVENT half at
  all, because none of them also runs the booking surface.

## Verified competitive facts (checked 2026-07-26; re-check before quoting)
- Fantastical ships native apps for Apple platforms and Windows and has NO browser-based calendar
  client at any tier; only its booking pages are on the web. Source: flexibits.com.
- Flexibits' Fantastical MCP connector (March 2026) runs locally against the Mac app's own
  database, so it is Mac-only by construction. Source: the Flexibits blog announcement.

## Limits (stated plainly)
- Google Calendar only today. Microsoft 365 and CalDAV (iCloud, Fastmail) are not connected yet.
- The calendar client is web only right now. There is no Mac, Windows, iOS, or Android app.
- No tasks, weather, travel time, or home-screen widgets in the client yet.
- Calendar show/hide is manual. Sets that switch automatically by time of day or location are not
  built.
- Standing instructions cover time-of-day windows and meeting length. They do not yet act on
  attendees, subject matter, or travel time, and they never auto-decline an existing meeting.

## Roadmap (NOT shipped; do not present as current)
- Native Mac, Windows, iOS, and Android clients over the same sync layer.
- Microsoft Graph and CalDAV providers.
- Invitee calendar overlay (see your own conflicts on the host's page).
- "Cal" AI scheduling assistant and two-sided agent-to-agent negotiation (MCP surface).
- Custom domain (book.yourname.com), payments/deposits, team pages.

## Pricing
Free tier (one booking link, core scheduling, Google sync, "Powered by Cachet" signature).
Paid tiers are in design and not yet on sale.

## Endpoints
- Cachet Calendar booking page: /b/<handle>
- Capabilities (this doc, human-readable): /capabilities
- Machine JSON: /capabilities.json