Skip to main content
Was this helpful?

AI Agents (MCP) Overview

PrimeCal includes a standards-compliant Model Context Protocol (MCP) server so AI tools can read and update calendars, tasks, automations, profile context, and enterprise reservation data through one integration surface.

What PrimeCal MCP Gives You​

  • Tools for:
    • calendar events and people groups
    • tasks, labels, and reminders
    • automation rules and audit snapshots
    • profile and context snapshots
    • organisations, resource types, resources, availability, and reservations
  • Resources for read-only context bundles:
    • primecal://current-context
    • primecal://automation-summary
  • Rich payloads so hosts get full context, not only IDs.

PrimeCal does not expose Stripe secrets, Checkout creation, or webhook handling through MCP in the current reservation pass.

Availability and Safety​

PrimeCal MCP is a core capability.

  • There is no feature flag to enable MCP.
  • MCP is available whenever PrimeCal is running with valid MCP configuration.
  • Safety is enforced through:
    • agent profiles
    • scoped permissions
    • agent API keys
    • organisation and resource-type scopes for reservation tools

Enterprise Reservation Support​

Reservation-aware MCP agents can:

  • list the organisations they can access
  • switch the active organisation safely
  • list resource types and concrete resources
  • calculate availability with reservation and blocking-calendar logic
  • create non-payment reservation flows where the configured permissions allow it

PrimeCal keeps the payment boundary separate. If a reservation requires Stripe payment, MCP does not create or complete that payment flow for the agent.

Canonical Demo User: May.B.Late​

All guides in this section use May.B.Late as the sample user.

Expected seeded profile:

  • Username: mayblate
  • Calendars: Work, Personal, Side projects
  • Task labels and tasks already present
  • At least one enabled automation rule
  • Profile settings tuned for MCP demos (timezone, time format, theme)

See Configuring an Agent in PrimeCal, Connecting MCP Hosts, and Enterprise Reservation Tools For MCP for the full flow.

Real UI Reference​

PrimeCal AI Agent settings area used to configure agent profiles, permissions, and API keys