Calendar API

Name: Calendar API API
Brand: Calendar API
Availability: InStock

✓ Official Vendor SpecProductivityCalendar Schedulingoauth237 EndpointsREST

For Agents

Create and manage calendar events, check attendee availability, and set up recurring schedules across Google Calendar accounts. Supports 37 operations covering events, ACLs, and real-time change watches.

Quickstart

Get started with Calendar API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"schedule a meeting on Google Calendar"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Calendar API API.

Create calendar events with attendees, locations, video conferencing links, and reminders

Query free/busy availability across multiple calendars for meeting scheduling

Set up recurring events using RRULE syntax with exceptions and modifications

Watch for calendar changes in real time via push notifications to webhook endpoints

GET STARTED

Start building with Calendar API API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Calendar API API for, with concrete tasks.

★ AI Agent Meeting Scheduling

AI agents use the Calendar API through Jentic to find available time slots, create meetings with attendees, and handle rescheduling requests. An agent searches Jentic for 'check calendar availability,' receives the freebusy.query schema, and executes the lookup across multiple calendars — no OAuth configuration needed. Handles timezone conversions, attendee conflict detection, and Google Meet link generation automatically.

Query free/busy availability for three attendees over next week using POST /freeBusy, find the first shared 1-hour slot, then create an event at that time with a Google Meet link

Event Management and Recurring Schedules

Create and manage complex recurring event schedules using RRULE syntax with support for exceptions, modifications to individual instances, and timezone-aware start/end times. The events.insert endpoint accepts full RFC 5545 recurrence rules and generates individual event instances that can be independently modified or cancelled. Supports all-day events, multi-day spans, and events with attachments.

Create a recurring weekly team standup event every Monday at 9:00 AM for 30 minutes with 5 attendees using POST /calendars/{calendarId}/events with recurrence rule RRULE:FREQ=WEEKLY;BYDAY=MO

Calendar Sharing and Access Control

Manage calendar visibility and access permissions programmatically through the ACL endpoints. Grant users specific access levels from freebusy-only to full owner control, share calendars with groups or domains, and audit current permissions. Supports delegation scenarios where assistants manage executive calendars with appropriate access boundaries.

Grant writer access to a secondary calendar for user assistant@company.com using POST /calendars/{calendarId}/acl with role='writer' and scope type='user'

Real-Time Calendar Sync

Subscribe to push notifications for calendar changes using the events.watch endpoint, enabling real-time synchronization between Google Calendar and external systems. Receive notifications when events are created, modified, or deleted without polling. Combined with incremental sync tokens, this enables efficient one-way or bidirectional calendar synchronization with external scheduling tools.

Set up a watch on a calendar's events using POST /calendars/{calendarId}/events/watch with a webhook URL, then poll for changes since the last sync token using GET /calendars/{calendarId}/events with syncToken

Key Endpoints

37 endpoints — create, modify, and query calendar events with attendee management, recurring event rules, and free/busy availability lookups across google calendar accounts.

METHOD

PATH

DESCRIPTION

POST

/calendars/{calendarId}/events

Create a new calendar event

GET

/calendars/{calendarId}/events

List events with time range and query filters

GET

/calendars/{calendarId}/events/{eventId}

Get a specific event by ID

PATCH

/calendars/{calendarId}/events/{eventId}

Update event details

DELETE

/calendars/{calendarId}/events/{eventId}

Delete an event

POST

/freeBusy

Query free/busy availability for calendars

POST

/calendars/{calendarId}/events/watch

Subscribe to event change notifications

POST

/calendars/{calendarId}/acl

Create an access control rule

POST

/calendars/{calendarId}/events

Create a new calendar event

GET

/calendars/{calendarId}/events

List events with time range and query filters

GET

/calendars/{calendarId}/events/{eventId}

Get a specific event by ID

PATCH

/calendars/{calendarId}/events/{eventId}

Update event details

DELETE

/calendars/{calendarId}/events/{eventId}

Delete an event

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Google Calendar OAuth 2.0 tokens with scopes (calendar, calendar.events, calendar.readonly) are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access tokens — raw OAuth credentials and refresh tokens never enter the agent's context.

Intent-based discovery

Agents search by intent (e.g., 'schedule a meeting' or 'check calendar availability') and Jentic returns matching Calendar operations with their input schemas, required scopes, and recurrence rule format specifications, so the agent can execute scheduling operations without parsing Google's API documentation.

Time to first call

Direct Calendar integration: 2-4 days for OAuth setup, timezone handling, recurrence rule construction, and attendee management. Through Jentic: under 1 hour — search for the operation, load the schema, execute with auth handled automatically.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Calendly API

Scheduling platform with booking pages, availability rules, and appointment types

Choose Calendly when you need public-facing booking pages with customizable availability rules rather than direct calendar manipulation

Complementary

Zoom Meetings API

Video conferencing with meeting creation, recording, and participant management

Use alongside Calendar when you need to create Zoom meetings linked to calendar events rather than using Google Meet

Complementary

Gmail API

Email invitations and notifications for calendar events

Use alongside Calendar when you need to send custom email notifications about events beyond the built-in Calendar invitation system

Complementary

Slack API

Team messaging for calendar event reminders and scheduling notifications

Use alongside Calendar when you need to post meeting reminders or scheduling updates to team channels

FAQs

Specific to using Calendar API API through Jentic.

What authentication does the Google Calendar API use?

The Calendar API uses OAuth 2.0 with scopes including calendar.readonly for read-only access, calendar.events for event management, and calendar for full calendar control. Through Jentic, OAuth tokens are stored in the MAXsystem vault. The API supports both implicit and authorization code OAuth flows.

Can I check meeting availability across multiple people with the Calendar API?

Yes, the POST /freeBusy endpoint accepts a list of calendar IDs and a time range, returning busy intervals for each calendar. You can query up to 50 calendars in a single request with a time window up to 2 months. The response shows exactly which time slots are free across all participants.

What are the rate limits for the Google Calendar API?

The Calendar API allows 1,000,000 queries per day per project and enforces per-user rate limits of approximately 10 queries per second. Event creation and modification have stricter per-calendar limits. Batch requests can combine multiple operations to reduce quota consumption.

How do I create a recurring event with the Calendar API through Jentic?

Search Jentic for 'create recurring calendar event' to get the POST /calendars/{calendarId}/events schema. Set the recurrence field with an RRULE string like 'RRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR' for specific days. Install Jentic with pip install jentic, authenticate at https://app.jentic.com/sign-up, and execute with the loaded schema.

Is the Google Calendar API free to use?

Yes, the Calendar API is free with no per-call charges. You need a Google Cloud project with the Calendar API enabled. Usage is governed by daily quota limits (1,000,000 queries/day per project) and per-user rate limits rather than pricing tiers.

Can I add a Google Meet link when creating an event?

Yes, include conferenceData in your event creation request with createRequest containing a requestId and conferenceSolutionKey of type 'hangoutsMeet'. Set conferenceDataVersion=1 as a query parameter on the POST /calendars/{calendarId}/events call. The response includes the generated Meet link in conferenceData.entryPoints.

How do I sync calendar changes to an external system?

Use POST /calendars/{calendarId}/events/watch with a webhook URL to receive push notifications on event changes. For initial sync, call GET /calendars/{calendarId}/events and store the nextSyncToken. On subsequent calls, pass syncToken to receive only incremental changes since the last sync.