Connect Google Calendar
A link that opens a page naming the business, where the owner, or a person for their own page, connects Google Calendar in one click.
Free*
*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.
An example
Connect my Google Calendar so nobody can book me when I'm already busy.
Your agent callscalendar_connectFree*
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.
{
"provider": "google"
}Use it when
Bookings should avoid the owner's busy times and appear in their own calendar, or a person with a booking page of their own should connect theirs.
- For an Outlook calendar on Microsoft 365, use
m365_connect.
What it does
A link to connect a Google calendar: the owner's for the business's calendar, or with person, that person's own. The page names the business, one click connects, and bookings then avoid busy times and appear in it (Google also emails the attendee an invitation). The link works once, for an hour. Then pick the calendar with calendar_setup connected_calendar_id. Outlook calendars: the microsoft365 tools work in them directly.
What comes back
The link (it works once, for an hour), how many minutes it works, and a sentence to send with it to the owner or the person. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
providerRequired | string | One of: google. |
person | string | Someone on the account, by email: their own calendar instead of the business's. Up to 254 characters. |
The call
Over MCP, call calendar_connect on https://api.conecto.chat/mcp/calendar. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/calendar_connect \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"provider":"google"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
unavailable503 | Google Calendar connections are not switched on yet. | Keep the calendar's own hours for now. |
More Calendar tools
All 13 tools- Set up the calendar
calendar_setupSets the business's calendar or a person's own: name, booking address, time zone, weekly hours, closed days, reminder emails and confirmation calls.$0.001 a call - Get the calendar setup
calendar_get_setupThe calendar's settings, booking page, iCal link, connected Google calendar, meeting types, and its people's own calendars.Free* - Save a meeting type
calendar_save_meeting_typeCreates or changes a kind of meeting people can book, on the business's calendar or a person's, taken by one host, a round robin or everyone.$0.001 a call - List meeting types
calendar_list_meeting_typesEvery meeting type people can book, the business's and each person's own, with its hosts and booking page.Free* - Find free times
calendar_find_timesFree start times for a meeting type between two dates, in the time zone you ask for.Free* - Book a meeting
calendar_bookBooks a free time for someone, who gets a confirmation email with an invite and a link to change it.$0.01 a call - List bookings
calendar_list_bookingsBookings between two times (from now on by default), soonest first, with each one's hosts, guests and confirmation call.Free* - Move a meeting
calendar_moveMoves a booking to another free time and sends the attendee an updated invite.$0.01 a call
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md