Calendar
The Calendar module manages workspace calendars and calendar events for meetings, launches, reviews, deadlines, reminders, and operating cadence.
What it does
Use Calendar when a workflow needs time-based coordination:
- Create calendars for teams, projects, campaigns, releases, ventures, support operations, or customer work.
- Create events with start and end times, status, event type, owner, and related resource links.
- Link events to CRM, Support, Tasks, Projects, Products, CMS, and Activity Log records.
- Use calendar data to coordinate agent-created follow-ups, reviews, launch plans, and customer meetings.
Resource model
| Resource | Purpose |
|---|---|
calendars | Workspace calendars with name, status, owner, and metadata. |
calendar_events | Time-based records with schedule, status, event type, related resource links, and notes. |
REST surface
Calendar REST endpoints live under /v1/calendar/...:
GET /v1/calendar/calendarsPOST /v1/calendar/calendarsPATCH /v1/calendar/calendars/{calendar_id}GET /v1/calendar/eventsPOST /v1/calendar/eventsPATCH /v1/calendar/events/{event_id}
All routes require the Calendar module to be enabled for the workspace before scope checks can succeed.
Permissions
Use calendar:read to list calendars and events. Use calendar:write to create or update calendars and events.
Recommended scoped credentials for scheduling workflows:
calendar:read
calendar:write
tasks:read
tasks:write
activity:write
crm:read
support:read
Add project, product, or CMS scopes when events should attach to those records.
Example workflow
Prompt:
Create a customer onboarding calendar, schedule a kickoff meeting next Tuesday, link it to the onboarding project and customer company, create a reminder task, and log the scheduling activity.
Expected operations:
- Create or find the workspace calendar.
- Create the calendar event with start and end times.
- Link the event to related project, CRM, Support, or CMS context.
- Create a task for preparation or follow-up.
- Log the activity.
Audit and usage
Calendar writes create audit events and usage events with request IDs. Use request IDs to connect scheduling changes to related tasks, projects, CRM records, and activity history.
MCP guidance
Calendar records are available through REST. Dedicated MCP tools are not listed in the public MCP tool registry for this module. Agent workflows can combine REST calendar records with MCP tools from Tasks, Activity Log, CRM, Support, Projects, Products, and CMS.
