Read a Google Calendar

google_calendar_events · Reads only · Markdown

The events in a mailbox's calendar between two times, in UTC.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

What is on the support team's Google Calendar next week?

Your agent callsgoogle_calendar_eventsFree*

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments

{
  "mailbox": "support@halversoncycle.example",
  "start": "2026-10-19T00:00",
  "end": "2026-10-24T00:00",
  "timezone": "Europe/Berlin"
}

What comes back

{
  "mailbox": "support@halversoncycle.example",
  "events": [
    {
      "id": "3q8v1jdk2n0s7c5t9b4e6m1a2f",
      "subject": "Fitting call: Hannah Price",
      "start": "2026-10-24T09:30:00Z",
      "end": "2026-10-24T10:15:00Z",
      "location": "Workshop",
      "organizer": "support@halversoncycle.example",
      "attendees": [
        "hannah.price@example.com"
      ],
      "online_meeting": null,
      "cancelled": false,
      "link": "https://www.google.com/calendar/event?eid=M3E4djFqZGsy"
    }
  ]
}

Use it when

Before booking, to find a free slot, or to brief someone on their week.

What it does

The events in a mailbox's calendar between start and end (at most 62 days), in UTC: subject, time, place, organizer, attendees and the Meet link. Free.

What comes back

mailbox; events: each with id, subject, start, end, location, organizer, attendees, online_meeting, cancelled and link. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`mailbox`	string	One of the mailboxes the agent may act as; optional when only one is connected. Up to 254 characters.
`start`Required	string	Up to 40 characters.
`end`Required	string	Up to 40 characters.
`timezone`	string	For start and end without an offset. Up to 60 characters.

The call

Over MCP, call google_calendar_events on https://api.conecto.chat/mcp/googleworkspace. Over REST:

Terminal

curl -X POST https://api.conecto.chat/v1/tools/google_calendar_events \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mailbox":"support@halversoncycle.example","start":"2026-10-19T00:00","end":"2026-10-24T00:00","timezone":"Europe/Berlin"}'

When it refuses

A refused call costs nothing and says what to do next.

Code	When	What to do
`not_connected`409	Google Workspace isn't connected yet.	Connect it with google_connect.
`not_allowed`403	The mailbox is not one the agent may act as.	Use a connected mailbox; the owner adds one by connecting again.
`invalid_input`400	A time is not ISO, or end is not after start, or over 62 days.	Send times like 2026-10-20T14:00 with a timezone.

More Google Workspace tools

All 11 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md

Read a Google Calendar

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Google Workspace tools

Give this to your agent.