Google Calendar

Connect Google Calendar to ORQO so that agents can list, create, update, and manage calendar events through MCP tools.

Category	Productivity
Capabilities	MCP tools only (no send/receive channel)
Adapter path	/google_calendar
Auth method	OAuth 2.0 (shared Google credential)

info

Google Calendar is an MCP-only integration. It provides tools for agents to manage calendar events programmatically — listing upcoming events, scheduling meetings, updating details, and checking availability. It does not support inbound event notifications through Doorkeeper or channels.

Prerequisites

• A Google account with Google Calendar access
• A Google Cloud project with the Google Calendar API enabled
• OAuth 2.0 credentials (client ID and client secret)
• Access to the ORQO Settings area

Setup

1. Set Up Google Cloud Credentials

1. Go to the Google Cloud Console.
2. Create a project (or select an existing one).
3. Enable the Google Calendar API under APIs & Services > Library.
4. Navigate to APIs & Services > Credentials and create OAuth 2.0 Client ID credentials (or reuse credentials from another Google integration).
5. Set the redirect URI to the OAuth Callback URL shown on the app's detail card in ORQO.
6. Note the client ID and client secret.

2. Install the Google Calendar App in ORQO

1. Navigate to Settings > Integrations in ORQO.
2. Switch to the Catalog tab and find Google Calendar.
3. Click the card to view details, then click Install.

3. Add or Link Credentials

Google Calendar uses the shared Google OAuth credential:

Credential	Type	Description
GOOGLE_OAUTH2	oauth2	OAuth 2.0 credentials (client ID, client secret, tokens)

Create the credential in Settings > Credentials with your Google Cloud client ID and client secret, then assign it to the Calendar app. If you already have a GOOGLE_OAUTH2 credential from another Google integration (Drive, Gmail), assign that same credential — no need to create a new one.

Shared Google credential

All Google integrations (Drive, Gmail, Calendar) share the same GOOGLE_OAUTH2 credential. Install any of them first — the others will reuse it.

4. Authorize via OAuth

1. Click Connect with OAuth on the Google Calendar app card.
2. Google's consent screen shows the requested Calendar permissions.
3. Approve access. ORQO stores the tokens and refreshes them automatically.

Because all Google integrations use incremental authorization, authorizing Calendar adds the Calendar scope to your existing Google token — it does not revoke Drive or Gmail access.

5. Verify the Connection

Click Verify on the Google Calendar app card. This tests the connection and discovers the available MCP tools.

Available Tools

Tool	Description
google_calendar_list_events	List upcoming events (filter by date range, calendar, or search query)
google_calendar_get_event	Get full event details including attendees and conference links
google_calendar_create_event	Create a new event with title, time, attendees, location, and description
google_calendar_update_event	Update an existing event (only provided fields are changed)
google_calendar_delete_event	Delete a calendar event
google_calendar_list_calendars	List all calendars accessible to the user

These tools are discovered automatically when the app is verified and can be assigned to agents via Skills.

Date and Time Formats

The Calendar tools accept ISO 8601 date-time strings:

Format	Example	Use
Date + time + timezone	2025-01-15T10:00:00-07:00	Timed events
Date + time in UTC	2025-01-15T17:00:00Z	Timed events (UTC)
Date only	2025-01-15	All-day events

Platform-Specific Behavior

• OAuth 2.0 with incremental scopes — Calendar uses the calendar scope. When authorized alongside Google Drive or Gmail, scopes are merged into a single token.
• Primary calendar default — All tools default to the user's primary calendar. Pass a calendar_id (from google_calendar_list_calendars) to work with other calendars.
• Recurring events — google_calendar_list_events expands recurring events into individual instances (singleEvents: true), so each occurrence appears separately in the results.
• Attendee management — google_calendar_create_event and google_calendar_update_event accept comma-separated email addresses for attendees. Google sends invitation emails automatically.

What's Next

• Google Drive — file access using the same Google credential
• Gmail — email management using the same Google credential
• Create a Skill — bundle Calendar tools for agents
• Set Up an App — general app installation guide