Skip to main content

212 docs tagged with "primecal"

View all tags

Acceptable Use Policy

What PrimeCal may and may not be used for — guidelines for responsible use of the platform.

Accessibility Guidelines

How PrimeCal supports keyboard navigation, screen readers, and color contrast — and how to set up your calendar for the best accessible experience.

Action Reference

Complete enumeration of all automation action types in PrimeCalendar, with implementation status and required config fields.

Actions Overview

Understand the action types PrimeCal automations can run after a trigger matches.

Adding a New Language

Steps to add a new supported language to PrimeCal's frontend and backend locale files.

Agent API

Code-backed reference for agent profile management, scoped permissions, API keys, and PrimeCal MCP runtime access.

AI Agents (MCP) Overview

What the PrimeCal MCP server is, what it exposes, and how to start with secure agent profiles, organisation scopes, and API keys.

All-Day Events

Create and manage all-day events in PrimeCal for holidays, deadlines, trips, and anything that spans a full day without a specific time.

API Overview

Swagger-style overview of the PrimeCal non-admin backend API surface, grouped by real product areas.

Appearance Settings

Customize PrimeCal's visual appearance — choose a theme color, adjust the calendar width, and configure how your workspace looks.

Authentication API

Code-backed reference for registration, login, onboarding, MFA, OAuth, refresh tokens, and user API key management.

Authentication Errors

Reference guide for HTTP 401 and 403 authentication/authorization error codes in PrimeCalendar, with causes and fixes for each.

Automation API

Code-backed reference for automation rules, audit logs, approvals, webhook triggers, and smart values.

Automation Patterns

Proven automation rule patterns for PrimeCal — color-coding, webhook integrations, and scheduled reminders that save real time.

Automation Templates

Start faster with pre-built automation rule patterns for common calendar workflows.

Booking API

Code-backed reference for enterprise reservations, availability, public booking, Stripe-backed payment state, and legacy token booking routes.

Booking Notifications

What notifications PrimeCal sends when a reservation is made or changed, and how to extend booking alerts using the automation system.

Booking Questions and Forms

How to configure the customer information fields on your PrimeCal public booking form, and what customers see when they fill in their details.

Booking Resources

How team members and customers create reservations for PrimeCal resources — from the public booking page and from within the internal reservation board.

Buffer Time

How buffer time works in PrimeCal resource bookings, and how to use blocked events to protect personal schedule gaps.

Calendar API

Code-backed reference for calendars, calendar groups, and sharing flows.

Calendar Colors and Visibility

Use PrimeCal's 16-color system to tell calendars apart at a glance, and control which calendars are visible without deleting them.

Calendar Embedding

What calendar embedding options exist in PrimeCal today, and what is planned.

Calendar Groups

Create, rename, assign, hide, unassign, reorder, and delete PrimeCal calendar groups without losing the calendars inside them.

Calendar Settings

Edit a calendar's name, color, and description at any time from the sidebar three-dot menu.

Calendar Sharing Issues

Troubleshoot problems with shared calendars and calendar groups in PrimeCalendar, including permission errors, missing shared calendars, and group sync issues.

Calendar Subscriptions

Subscribe to public iCalendar feeds in PrimeCal to follow external schedules like holidays or sports.

Calendar Views

Understand how Focus, Month, and Week views render PrimeCal calendars, events, labels, and colors.

Calendar Workspace

Create, edit, group, hide, rename, recolor, and manage calendars from the PrimeCal workspace.

Case Studies

How real users and organizations use PrimeCal to organize their schedules and collaborate effectively.

Checking Availability

How to see what times are free for yourself or others in PrimeCal, using calendar visibility, shared calendars, and the week view.

CI and Testing Overview

PrimeCal CI lanes, release triggers, local equivalents, and the current hosted verification policy.

Community Forum

Where to connect with other PrimeCal users and share tips, feedback, and experiences.

Compliance API

Code-backed reference for privacy access, exports, data-subject requests, consent updates, and policy acceptance.

Condition Reference

Complete enumeration of all automation condition fields and operators in PrimeCalendar.

Connecting MCP Hosts

Host-specific setup for Chrome MCP and desktop hosts (Claude Desktop, VS Code, Cursor) using PrimeCal MCP.

Connecting via OAuth (Sign In and Approve)

Connect PrimeCal to an AI assistant the same way you'd connect Google Calendar or Microsoft 365 — sign in, choose a permission level, approve, and manage the connection from Agent Settings.

Cookie Policy

What cookies and storage PrimeCal uses and why — plus what a deployment-specific Cookie Policy should address.

Creating Calendars

Create separate calendars for different areas of your life — family, work, school, hobbies — each with its own color and purpose.

Creating Events

Create events from the PrimeCal workspace, understand the shared event modal, and learn how saved events behave across the views.

Creating Resources

How to add a new bookable resource to your PrimeCal organisation — name, capacity, resource type assignment, and public booking token.

Creating Your Account

Register in PrimeCal, complete the onboarding wizard, and understand the exact fields and required decisions shown to new users.

Creating Your First Event

Use the PrimeCal event modal, understand the visible fields, and create a first event that behaves correctly in every view.

Custom Integrations

Build custom integrations with PrimeCal using the REST API, personal API keys, and automation webhooks.

Customizing Booking Pages

Configure the PrimeCal public booking page so customers see the right service choices, language controls, summary details, and payment actions.

Data Processing Agreement

Framework for Data Processing Agreements (DPAs) between PrimeCal operators and their users — specific DPA terms depend on your deployment.

Date and Time Formats

Configure your preferred time format (12-hour or 24-hour), week start day, and date display preferences in PrimeCal.

Deleting Calendars

Permanently remove a calendar and all its events from PrimeCal. This action cannot be undone — read what to consider first.

Deployment Guide

Security-hardening guidance for self-hosted and production PrimeCal deployments.

Developer Documentation

PrimeCal developer entry point for the full non-admin backend API, grouped by real product features.

Development Workflow

PrimeCal branch flow, local verification steps, Dependabot handling, and release expectations.

Editing and Deleting Events

Update event details or remove events you no longer need, including how to handle changes to recurring event series.

Email Notifications

Understand which emails PrimeCal sends and how to control your email notification preferences.

Enterprise Reservation Tools For MCP

Understand the reservation and organisation MCP tools, active-organisation behavior, and permission scopes for enterprise reservation workflows.

Event API

Code-backed reference for event CRUD, recurrence, calendar-scoped queries, and event comments.

Event Sync Issues

Diagnose and fix problems where external calendar events are not appearing in PrimeCalendar, or where duplicate events appear after syncing.

Everyday Planning FAQ

Real-life answers about registration, calendars, groups, colors, visibility, Focus behavior, and feature navigation in PrimeCal.

Experience Modes Overview

Compare Production, Focus, and Kid Mode, and learn how to switch between them from the mode selector in the header.

External Sync

Connect Google or Microsoft calendars, choose mappings, and manage PrimeCal external sync settings.

External Sync API

Code-backed reference for Google and Microsoft calendar sync setup, OAuth callbacks, mapping, disconnect, and force-sync operations.

FAQ

Fast, real-world answers for registration, calendars, tasks, automation, sync, AI agents, privacy, access, and troubleshooting in PrimeCal.

Finding Meeting Times

How to use PrimeCal's week view and calendar visibility controls to find an open slot that works for everyone.

Focus and Scheduling

See today's priorities in one place, run a Focus Session timer, let PrimeCal find an open slot automatically, and manage delegation and dependencies.

Focus Mode

A stripped-down Experience Mode that removes distractions and shows only your calendar and a simple task list.

Focus Mode And Live Focus

Use PrimeCal live Focus, clean focus mode, and hidden Focus labels to reduce distraction without hiding events from Month or Week views.

Getting Started

Start here for the real PrimeCal first-run flow: registration, onboarding, calendar setup, groups, and the first event.

Glossary

Definitions for key PrimeCal terms — calendars, events, views, sharing, automation, and more.

Glossary

Definitions of key PrimeCal terms — calendars, events, automation, sync, and developer concepts.

Google Calendar Sync

Connect your Google Calendar to PrimeCal so your Google events appear alongside your PrimeCal events.

Google Sync Problems

Fix Google Calendar sync issues in PrimeCal — reconnecting accounts, missing events, and handling duplicates.

Household Inventory

Track shared household items with shelf-life and low-stock-quantity awareness so PrimeCal can raise a restock task before you run out.

Household Items API

Code-backed reference for shared household inventory, shelf-life tracking, low-stock quantity thresholds, and marking items used up or consumed.

i18n Migration Plan

Rollout steps for enabling multilingual behavior on existing single-language PrimeCal deployments, with safe rollback.

i18n String Inventory

Generated audit of hardcoded user-facing strings across the PrimeCal frontend and backend, by coverage bucket.

Initial Setup

Create your first real calendar, organize calendar groups, and prepare the PrimeCal sidebar for daily use.

Internationalization

How PrimeCal's frontend i18n works — i18next setup, translation files, language detection, and how to add or update translation keys.

Keyboard Shortcuts

Speed up your PrimeCal workflow with keyboard shortcuts for navigation, view switching, and event creation.

Kid Mode

A safe, simplified Experience Mode for children ages 4-8, protected by a PIN so only a grown-up can exit it.

Language and Locale

Change PrimeCal's interface language and locale settings — available in English, Hungarian, German, and French.

Login Problems

Fix the most common reasons you cannot sign in to PrimeCal, including expired sessions, wrong credentials, and OAuth errors.

Managing Bookings

Review confirmation, payment, retry, and follow-up behavior for PrimeCal public bookings.

MCP Event Listing Best Practices

Recommended request shapes for PrimeCal MCP event retrieval, including compact field sets, pagination patterns, and recurrence usage.

MCP Server Architecture

High-level architecture of the PrimeCal MCP server — transport, authentication, permissions, and error mapping.

Meeting Analytics

What PrimeCal offers for understanding event and meeting patterns in v1.3.4.

Microsoft 365 Sync Problems

Fix Microsoft 365 and Outlook calendar sync issues in PrimeCal — reconnecting accounts, missing events, and permission errors.

Microsoft Teams Integration

Post PrimeCal event notifications to Microsoft Teams channels using automation webhooks, and sync Teams meeting invites via Microsoft 365.

Mobile App Issues

Fix common problems with the PrimeCal mobile app on Android and iOS, including blank screens, outdated content, and navigation issues.

Mobile App Overview

PrimeCal is available as a native mobile app for iOS and Android — built on the same web app you know, wrapped for your phone.

Mobile vs. Web Features

Compare what's available in PrimeCal's mobile app versus the web — they share the same features, with a few presentation differences.

Mobile Widgets

Add PrimeCal widgets to your iPhone or Android home screen for at-a-glance access to your upcoming events.

Navigating the Calendar

Learn how to move around PrimeCal — switching views, jumping to dates, showing and hiding calendars, and using keyboard shortcuts.

Network Errors

Diagnose and fix network errors you see when using PrimeCal, including connection failures, timeout errors, and sync failures.

Notification Classes Reference

The five notification priority classes, their default routing behavior, the inbox-rule actions that can override them, and the notification lifecycle states with the entity/column backing each one.

Notification Not Received

Troubleshoot missing event reminders, email notifications, and in-app notification issues in PrimeCal.

Notification Preferences

Control which PrimeCal notifications you receive, how they're delivered, and what priority they get.

Notifications API

Code-backed reference for inbox listing, preferences, devices, filters, rules, mutes, notification threads, priority classification, Mode Packs, and digests.

OAuth Authorization Server (MCP)

How PrimeCal's OAuth 2.1 + PKCE + Dynamic Client Registration authorization server maps onto the Agent/AgentApiKey model, and why access/refresh tokens use a separate JWT domain from the login session.

OAuth Issues

Fix OAuth authorization errors when connecting Google or Microsoft accounts to PrimeCal.

Offline Mode

Understand how PrimeCal handles poor connectivity and what works when you're offline.

Organization API

Code-backed reference for organisation creation, membership, active-organisation switching, branding, and Stripe Connect administration.

Paid Bookings

Enable paid booking types, understand pending payment confirmation, and review the customer payment experience in PrimeCal.

Penetration Testing

Guidance for penetration testing PrimeCalendar — what controls exist, what the attack surface looks like, and what is known to be incomplete.

Performance Issues

Fix sluggish calendar loading, slow event rendering, and high memory usage when using PrimeCal.

Permission Errors

Understand and resolve PrimeCalendar permission errors including FEATURE_NOT_ENTITLED, PLAN_LIMIT_REACHED, and calendar access denied messages.

Permission Levels

What Read, Write, Admin, and Owner mean in PrimeCal calendar sharing.

Personal Logs

Review your private PrimeCal activity history, privacy actions, and personal account records.

Personal Logs API

Code-backed reference for the signed-in user's personal audit feed and summary endpoints.

Plans And Access FAQ

Understand why features may differ between users, how usage plans affect access, and what to do when a capability is missing.

Platform API

Code-backed reference for health checks, feature flags, monitoring, frontend error ingestion, security reports, and honeypot endpoints.

Pool Booking

Configure resource-type pool booking, understand bookingMode choices, and document how PrimeCal prices multi-resource reservations.

Pool Booking API

Code-backed contract for bookingMode configuration, requestedQuantity semantics, pricing mathematics, and public pool-booking payloads.

Post-Payment Customer Linking

How PrimeCal resolves or creates customer accounts after a successful public booking payment, and what the API returns.

PrimeCal Calendar Events List v2

Breaking-change reference for the compact PrimeCal MCP event-listing contract, including timezone behavior, recurrence expansion, pagination, and field selection.

PrimeCal Documentation

Start with registration, move into daily planning, then continue into automation, MCP, sync, and the full API reference.

PrimeCal Reservations Availability v2

Reference for the PrimeCal MCP reservation availability v2 contract, including UTC timestamps, logical timezone metadata, and userTimezone overrides.

PrimeCal Reservations Create v2

Reference for PrimeCal MCP reservation creation v2, including UTC-normalized success responses and AI-friendly conflict and payment error bodies.

Privacy Policy

What data PrimeCal collects, how it is stored, and your rights as a user — specific terms depend on your deployment.

Production Mode

Production is the default Experience Mode — every PrimeCal feature is visible and available.

Profile Page

Manage account identity, preferences, labels, theme, focus filters, and password settings from the PrimeCal profile screen.

Push Notifications

Enable browser and mobile push notifications in PrimeCal to get real-time alerts about your events.

Recurring Events

Set up events that repeat automatically on a daily, weekly, or monthly schedule so you never have to re-enter your regular routines.

Resource API

Code-backed reference for active-organisation resource types, concrete resources, pricing configuration, and public booking token helpers.

Resource Availability

Configure organisation-level and resource-level opening hours so PrimeCal only offers bookable slots that match your real availability.

Resource Management

How to edit, deactivate, delete, and maintain bookable resources in PrimeCal, including schedule modes and capacity child lanes.

Routine Templates API

Code-backed reference for routine templates, items, cloning, on-demand instantiation, streaks, skipping, and the household fairness view.

Routines and Templates

Build or clone chore templates, choose automatic or manual-only triggering, assign fair rotation, start a routine on schedule/by hand/from automation, skip an occurrence, and track completion streaks.

Searching Events

Find any event quickly by searching titles, descriptions, locations, and notes across all your calendars.

Secrets Management

How PrimeCalendar handles secrets and environment variables in deployment, including current gaps and best practices.

Security And Privacy FAQ

Practical answers about passwords, MFA, Personal Logs, privacy exports, deletion requests, and what user privacy controls actually mean in PrimeCal.

Security Best Practices

Practical steps every PrimeCal user can take to protect their account, calendars, and shared data.

Security Hardening

Deployment-level security hardening for PrimeCalendar — HTTP headers, CORS, JWT configuration, rate limiting, and known gaps.

Security Whitepaper

PrimeCal's technical security architecture — authentication, data protection, input validation, and audit logging.

Setting Up Booking Links

Create organisation booking links, choose the right service and payment settings, and verify the public flow in English and Hungarian.

Sharing Calendars

How to share a PrimeCal calendar with specific people and manage their access.

Skins & Appearance

Skins change how PrimeCal looks — colors, fonts, and spacing — without changing what you can do. Learn how they differ from Experience Modes.

Slack Integration

Send PrimeCal event notifications to Slack using automation webhooks.

Smart Values

Use dynamic data from events and webhooks inside your automation conditions.

Smart Values Reference

Complete reference of automation smart value paths available by trigger type in PrimeCalendar.

Smart-Home Automation

Call a real smart-home device's REST API from a rule, and let a webhook or scheduled trigger start a routine on demand.

Stripe and Paid Bookings

How paid booking confirmation works in PrimeCal, the booking state machine, and the API surfaces for billing and public bookings.

Support Contact

How to get help with PrimeCal — where to look and how to reach the right person.

System Requirements

What you need to use PrimeCal — supported browsers, mobile OS versions, and network requirements.

Tasks API

Code-backed reference for task CRUD, task labels, focus, focus sessions, auto-scheduling, delegation, dependencies, checklists, and label attachment.

Tasks Workspace

Capture, organize, and complete tasks in PrimeCal with labels, due dates, checklists, quick-create tools, focus sessions, and routines — all in one unified Tasks hub.

Team Collaboration Tips

Practical habits for using PrimeCal effectively with a family, team, or group — from shared calendars to automation rules everyone benefits from.

Terms of Service

Overview of the Terms of Service that govern use of PrimeCal — specific terms depend on your deployment and provider.

Testing Strategy

PrimeCal test layers, command map, MCP coverage, and the local verification order used by CI.

Time Tracking

What time-tracking capabilities exist in PrimeCal v1.3.4 and how to approximate time logging using calendar events.

Time Zone Handling

How to set your timezone in PrimeCal and what that means for events, external calendar sync, and scheduling across regions.

Translation Guide

Supported languages and style rules for writing and reviewing PrimeCal translations.

Trigger Reference

Complete enumeration of all automation trigger types in PrimeCalendar, with trigger type values, required config fields, and availability notes.

Triggers And Conditions

Learn the trigger types, condition fields, and operators supported by PrimeCal automation rules.

Troubleshooting FAQ

Practical checks for missing events, quiet Focus view, stale sync, task placement, automation misses, and AI agent permission issues in PrimeCal.

Unit Testing

How to write Jest unit tests for PrimeCal's NestJS services, guards, and DTOs.

User API

Code-backed reference for profile settings, language, permissions, user search, and current-user bootstrap routes.

User Documentation

Daily PrimeCal workflows for profile settings, calendars, tasks, automation, external sync, AI agents, and personal logs.

User Group API

Code-backed reference for people groups, invitations, members, and group-based calendar sharing.

Validation Errors

Understand HTTP 400 Bad Request validation errors in PrimeCalendar, including form field errors, DTO validation failures, and content type rejections.

Webhook Failures

Fix PrimeCal automation webhook failures — token issues, payload format, connection errors, and debugging tips.

Webhooks

Let external systems trigger your automation rules by sending a POST request to PrimeCal.

What Are Resources?

Understand the Resource concept in PrimeCal — what resources are, how they relate to resource types and bookings, and when to use them.

What Is PrimeCal?

An introduction to PrimeCal — who it's for, what it does, and why it might be exactly the calendar you've been looking for.

Working Hours Configuration

How to represent your working hours in PrimeCal using recurring events, so your schedule is clear to you and anyone who shares your calendar.