Add a Google Calendar event

google_calendar_create · Changes data · Markdown

Adds an event to a mailbox's calendar and invites its attendees, with a Meet link if asked.

$0.001 a call

From your agent’s balance. A call that fails costs nothing.

Book a video call with Hannah Price on Saturday at 11:30 to plan her fitting, with a Meet link.

Your agent callsgoogle_calendar_create$0.001 a call

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",
  "subject": "Fitting call: Hannah Price",
  "start": "2026-10-24T11:30",
  "end": "2026-10-24T12:15",
  "timezone": "America/Los_Angeles",
  "attendees": [
    "hannah.price@example.com"
  ],
  "online_meeting": true
}

What comes back

{
  "mailbox": "support@halversoncycle.example",
  "event": {
    "id": "k2b9c7d1e5f3g8h4j6m0n2p4q6",
    "subject": "Fitting call: Hannah Price",
    "start": "2026-10-24T18:30:00Z",
    "end": "2026-10-24T19:15:00Z",
    "location": null,
    "organizer": "support@halversoncycle.example",
    "attendees": [
      "hannah.price@example.com"
    ],
    "online_meeting": "https://meet.google.com/abc-defg-hij",
    "cancelled": false,
    "link": "https://www.google.com/calendar/event?eid=azJiOWM3ZDFl"
  }
}

Use it when

A customer or colleague agreed a time.

For a booking page where customers pick their own time, use calendar_save_meeting_type.

What it does

Put an event in a mailbox's calendar and invite its attendees, with a Google Meet link when asked. Times with an offset, or local to `timezone`. $0.001.

What comes back

mailbox; event: id, subject, start, end, location, organizer, attendees, online_meeting 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.
`subject`Required	string	1 to 255 characters.
`start`Required	string	Up to 40 characters.
`end`Required	string	Up to 40 characters.
`timezone`	string	Up to 60 characters.
`attendees`	array of strings	Up to 50 items.
`location`	string	Up to 255 characters.
`body`	string	Up to 10,000 characters.
`online_meeting`	boolean	Default: false.

The call

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

Terminal

curl -X POST https://api.conecto.chat/v1/tools/google_calendar_create \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mailbox":"support@halversoncycle.example","subject":"Fitting call: Hannah Price","start":"2026-10-24T11:30","end":"2026-10-24T12:15","timezone":"America/Los_Angeles","attendees":["hannah.price@example.com"],"online_meeting":true}'

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.
`vendor_rejected`502	Google refused: delegation is missing a scope, or Google said no.	Ask the Workspace admin to grant what the message names.
`invalid_input`400	A time or address is not valid, or end is not after start.	Fix what the message names.

More Google Workspace tools

All 11 tools

Give this to your agent.

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

Add a Google Calendar event

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.