Glossary
Key terms used throughout PrimeCal and this documentation.
A
Action The "then do this" part of an automation rule. An action defines what PrimeCal does when a trigger fires and conditions pass. Example: set the event color to Red.
Agent Profile A named configuration that controls what an AI agent (via MCP) can see and do in PrimeCal — which calendars it can access, what write permissions it has, and which API key it uses.
API Key A credential used by external systems or AI agents to access the PrimeCal API. Generated from your profile settings. Each key can be scoped to specific permissions.
Automation Rule A set of conditions and actions that run automatically when a trigger fires. Example: when an event is created with "Doctor" in the title (condition), set its color to Red (action).
C
Calendar A named container for events, with a color and visibility setting. Each user has a "Default" calendar and can create additional ones (e.g., Work, Personal, Family). Calendars can be shared with other users or groups.
Calendar Group An organizational label for grouping multiple calendars under a heading in the sidebar. Groups do not affect event data — they are purely for display organization. Example: a "Family" group containing "May's Calendar", "Will's Calendar", "Noah's Calendar".
Condition
A filter inside an automation rule. Conditions evaluate the event's fields (like title or duration) or webhook payload data, using operators like contains, equals, or greater_than. Multiple conditions can be combined with AND/OR logic.
Create Event Adding a new scheduled item to a calendar. Events have a title, start time, end time, description, location, color, and calendar assignment.
E
Event A scheduled item with a start time, end time, title, and calendar. Events are the core units of PrimeCal. Events can be all-day or time-specific, single or recurring.
External Calendar Sync A feature that connects a Google or Microsoft 365 account to PrimeCal, importing events from that account's calendar. See External Sync.
F
Feature Flag A setting (controlled by PrimeCal administrators) that enables or disables a feature for all users or for specific plans. When a feature is disabled via its flag, its UI doesn't appear.
Focus Mode / Live Focus A calendar view filter that shows only events matching specific calendars or labels. Focus Mode reduces visual noise when you want to concentrate on one area of your schedule. Live Focus updates in real time as new events come in.
M
MCP (Model Context Protocol)
An open standard for connecting AI assistants to tools and data sources. PrimeCal implements MCP at https://api.primecal.eu/api/mcp, allowing Claude, Claude Desktop, and compatible AI hosts to read your calendar and create events on your behalf. See MCP Overview.
MCP Tool
A specific action available to an AI agent via the MCP server. Examples: primecal_calendars_events_list (list events), primecal_reservations_create (create a booking).
O
OAuth The authorization protocol used when connecting Google or Microsoft accounts to PrimeCal. OAuth lets you approve access without sharing your password — Google or Microsoft handles authentication and issues a token to PrimeCal.
Organisation An enterprise-level grouping that owns resources and resource types for the reservation system. An organization has admins (editors) who configure resources and pricing.
P
People Group / User Group A named list of PrimeCal users that you can share calendars with as a single unit. Example: create a "Blate Family" group containing May, Will, Noah, and Sue — then share any calendar with the whole group in one step.
Personal Log / Personal Logs A private activity screen visible only to you, showing your own actions (events created, calendars shared, account changes) and GDPR data rights (access, export, delete requests).
Plan / Usage Plan A subscription tier that controls which features are enabled for a user's account. Examples: automation, external sync, reservations, and API access may be gated by plan. Plan management is handled by PrimeCal administrators.
R
Recurring Event An event that repeats on a schedule. PrimeCal supports daily, weekly, monthly, and custom recurrence patterns. You can edit a single occurrence or the entire series.
Resource A bookable item within an organisation's reservation system — a conference room, a piece of equipment, an appointment slot, a swimming lane. Resources belong to a Resource Type.
Resource Type A category of bookable resources — e.g., "Conference Rooms" (containing Room A, Room B, Room C). Resource types define availability mode (continuous or shifts) and buffer time.
Reservation A booking of a resource for a specific time. End customers can create reservations via the public booking link. Paid reservations integrate with Stripe for payment.
S
Seat A user account slot within a subscription plan that allows another user to share the plan's features. Seat management lets you invite team members who then use the plan's features without separate subscriptions.
Subscription Plan See Plan / Usage Plan.
T
Task An action item in the Tasks workspace. Tasks have a title, status, optional due date, and labels. The Tasks workspace is separate from the calendar view but lives alongside it in the navigation.
Trigger The "when this happens" part of an automation rule. Triggers include calendar events (created, updated, deleted), time-based events (event starts in X minutes), webhook calls, and external calendar imports.
W
Webhook (Incoming) A unique URL generated per automation rule that external services can POST JSON to. When a payload arrives, PrimeCal evaluates the automation rule's conditions against the payload data and fires the action if conditions pass.
Webhook Smart Values
Dot-notation paths for accessing nested data in a webhook payload. Example: webhook.data.order.status accesses status inside data.order in the incoming JSON body.
Week View / Month View Two calendar display modes. Week View shows time slots across a 7-day period, allowing drag-to-create. Month View shows a grid of days with event previews.