Skip to content
Docs menu

The Calendar app

Venom Calendar at /calendar: every connected calendar in one week view, connections and their rules, your hours, event types with a live preview, bookings, your profile, and the keyboard.

View .md

Calendar is a workspace app at /calendar, on the rail next to People and Funnel. g l opens it from any app, and ⌘K finds event types and bookings (type calendar: or bookings: to search only those). It has six pages: Week, Bookings, Event types, Availability, Connections and Profile.

Each page loads on its own. If one part can't be loaded, that page says so with a Try again button and the other pages keep working.

Week

The home page shows every calendar you've connected in one week, so you see your personal, company and client calendars side by side.

What How it looks
Busy time from a calendar a block in that calendar's colour, with the event's title (only you see titles; booking pages never do)
Tentative ("maybe") events the same block, striped
All-day events a bar in the row above the hours
Bookings solid dark cards with the invitee's name and the event type
Bookings waiting for you to confirm outlined cards marked Pending
Holds (a time someone has picked and is booking now) dashed outlines
Your bookable hours the default schedule's hours, shaded green

Overlapping events sit side by side. Each calendar keeps its own colour from Google unless two calendars share one; then Venom picks a different colour for the second. The list on the left shows and hides calendars and explains each mark.

The toolbar has Today, previous and next, Day, Week and Month views, the time zone you're viewing in (your profile's zone by default), and an optional second zone shown beside the hours, which is handy when you travel. The grid always shows 24 wall-clock hours, so on the day the clocks change an event keeps its local time.

On a phone the week is a list of days. The same list is what a screen reader reads, and on a wider screen l (or the List button) shows it in place of the grid.

"Share availability" (pick times on the grid and send them as text or a link) is coming with Calendar's agents.

Until you've set things up, a "Get started" strip lists the first steps: connect a calendar, set your hours, create an event type and share your link.

Connections

/calendar/connections. Accounts are grouped by provider.

  • Connect Google connects one Google account with read and write access, so bookings can be written into it with a Meet link. Do it once per account: personal Gmail, your company's Workspace, a client's Workspace.
  • Connect Google, busy only reads busy time and never writes.
  • Connect Microsoft connects one work, school or personal Microsoft account (Outlook, Microsoft 365); see Microsoft accounts.
  • Add .ics feed takes any calendar's secret address: a shared calendar, TripIt, an Outlook publish link. The address is stored sealed (.ics feeds covers what's read and how often).

If the server has no Google OAuth client (neither your org's own nor the operator's GOOGLE_CALENDAR_CLIENT_ID and GOOGLE_CALENDAR_CLIENT_SECRET), the page says so, the Connect Google buttons are off, and .ics feeds still work. Microsoft works the same way with MICROSOFT_CALENDAR_CLIENT_ID and MICROSOFT_CALENDAR_CLIENT_SECRET or the org's own Entra app. When a sign-in doesn't finish (you said no, it took too long, the provider didn't answer), you land back on the page with the reason and which provider it was.

An event type with a Microsoft Teams location shows a hint: Teams links need a work or school Microsoft account. On a personal Outlook.com calendar the location goes into the event as text.

Each account shows a light: Live (synced in the last few minutes), Syncing (first sync, or a while since the last one) or Error, with the reason in words and a Reconnect button. Remove disconnects the account and forgets its busy time.

Each calendar has four switches:

Switch What it does
Check conflicts its busy time blocks your booking pages
Tentative is busy "maybe" events count as busy
All-day is busy all-day events count as busy (off by default: most are reminders, not time away)
Receive invites it gets an invite for bookings written to another calendar, so it shows you as busy too

Members who can manage the organisation also see Your org's own Google OAuth client: the steps to create one in Google Cloud Console and a form for its client ID and secret. With your own client you skip Google's app review. The secret is needed each time you save, and saving needs the server's vault (VENOM_VAULT_KEYS).

Availability

/calendar/availability. A schedule is your working hours in one time zone. Edit the week by dragging on the grid (drag over empty time to add hours, over hours to take them away) or in the rows below it, which take several ranges a day. Copy Monday to weekdays fills Tuesday to Friday. Date overrides on the mini calendar make a day off or give one date different hours. One schedule is the default; new event types use it. Deleting a schedule moves the event types that used it to the default; deleting the default makes another schedule (the first by name) the default.

Event types

/calendar/types lists them and /calendar/types/{id} edits one. The list shows each event type's link with Copy link and an on/off switch. The editor has:

  • title, link (made from the title until you change it), description, durations (the first is the default) and location (Google Meet, a phone call either way, in person, a video link, or the invitee chooses)
  • the schedule, which calendars to check for conflicts (all of them by default), the destination calendar bookings are written to, and whether your other accounts get an invite
  • buffers before and after, how often start times are offered, minimum notice, how far ahead, and limits per day and per week
  • lock the time zone (in-person meetings), I confirm each booking, secret link, on or off
  • questions, with Venom Forms' field editor
  • reminders and integrations: the editor says what each does and links to Invites and reminders and Integrations; set them on the event type through the API or calendar_event_type_save

Beside the form, a preview of the booking page shows the next 10 free times as you edit. It's worked out from the busy time Venom already has; the booking page checks your calendars again before it books.

Event types and their hosts need a role that writes in Calendar: owner, admin or developer (who can do what). With the billing or viewer role, the list and the editor are read-only: New event type and the on/off switches are disabled, Edit reads View, the editor's fields and hosts can't be changed and it has no Delete. Hovering a disabled control says why. Week's first steps stop at Set your hours. Your own hours, schedules and bookings stay yours to change, whatever your role.

Bookings

/calendar/bookings has four tabs: Upcoming, Pending, Past and Cancelled. Each booking shows the invitee (linked to their page in People when Venom knows them), the event type, their answers, and the Meet link or location. Depending on its state: Confirm or Decline (pending; a declined booking is cancelled with the reason "declined" unless you give one), Reschedule, Cancel (with an optional reason in the email), or Mark no-show once it has started.

Reschedule moves the booking in place: it keeps its id and calendar invite, and Venom checks the new time is free first. If someone else took it, the dialog says so and the booking stays where it was. A booking can't be moved or cancelled once the meeting has started.

Where the app reads from

Every page uses the console routes under /api/workspace/calendar (accounts, calendars, .ics feeds, the Google connect and org client, profile, schedules, event types, links, slots and bookings; agents have the same operations as calendar_* tools, see Booking pages). The week grid reads GET /busy?from=&to= (up to 62 days): busy blocks from every connected calendar with their titles, live bookings and live holds. It's only for you in the app, so it has no agent tool: titles never reach agents or booking pages.

Profile

/calendar/profile: your handle (/meet/<handle>), display name, time zone and welcome text, with your public page's link to copy.

Keyboard

Keys never fire while you're typing in a field. The workspace's own keys (⌘K, ?, g then a letter) work here too.

Key Does
t Go to today
j or ← Previous day, week or month
k or → Next day, week or month
d Day view
w Week view
m Month view
l Show the week as a list
n New event type
/ Search event types and bookings
? Show every shortcut
g l Open Calendar from any app