Calendar - Doers

11 tools. Each one is also a REST route and a CLI command, from the same definition: the same input, the same output, the same errors.

Tool	What it does	Kind
`get_calendar_event`	Everything about one event	Read · idempotent · calls Google Calendar API
`get_calendar_status`	Whether Google Calendar is connected	Read · idempotent · no outside service
`list_calendar_events`	Events in a window	Read · idempotent · calls Google Calendar API
`list_calendars`	The calendars this account can see	Read · idempotent · calls Google Calendar API
`create_calendar_event`	Create an event	Write · calls Google Calendar API
`delete_calendar_event`	Delete an event	Write · destructive · idempotent · calls Google Calendar API
`disconnect_calendar`	Disconnect Google Calendar	Write · destructive · idempotent · no outside service
`move_calendar_event`	Reschedule an event	Write · idempotent · calls Google Calendar API
`rename_calendar_event`	Rename an event	Write · idempotent · calls Google Calendar API
`rsvp_to_calendar_event`	Answer an invitation	Write · calls Google Calendar API
`start_calendar_auth`	Begin the Google authorization	Write · no outside service

get_calendar_event

Everything about one event. Guests, video link, location and description: what the list deliberately omits because it would be fetched for every event to show a few. meetLink prefers Google’s own conferencing data and falls back to a link found in the location or description, which is where a Zoom or Teams invitation usually is. canRsvp and canEdit say what this account may do, so the app does not offer a button Google will refuse.


Kind	Read · idempotent · calls Google Calendar API
Auth	Bearer token: a personal API token (`pc_…`) or an OAuth access token (`pcat_…`)
REST	`GET https://api.doers.sh/v2/calendar/calendars/{calendarId}/events/{eventId}`
CLI	`doers calendar get-calendar-event`
Touches	no table directly
Operation	`getCalendarEvent`

Input

Field	Type	Required	Default	Allowed values	Description
`calendarId` (path)	string	yes			Google’s calendar id. `primary` is the account’s own.
`eventId` (path)	string	yes			Google’s event id.

Output

Output fields

Field	Type	Description
`event`	object \| null
`event.title`	string
`event.description`	string \| null
`event.location`	string \| null
`event.htmlLink`	string \| null	The event in Google Calendar.
`event.meetLink`	string \| null	Video call, from Google’s data or from the text.
`event.recurring`	boolean
`event.start`	string
`event.end`	string
`event.organizer`	object \| null
`event.organizer.name`	string
`event.organizer.self`	boolean
`event.attendees`	object[]
`event.attendees[].email`	string
`event.attendees[].name`	string
`event.attendees[].status`	string	Google’s own value; `needsAction` when they have not answered.
`event.attendees[].self`	boolean
`event.attendees[].organizer`	boolean
`event.selfStatus`	string \| null
`event.canRsvp`	boolean	You are a guest and not the organiser.
`event.canEdit`	boolean	You organise it, so Google will accept a change.

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_calendar_event",
    "arguments": {
      "calendarId": "5152790e-278e-4890-89f8-bfaa354b944e",
      "eventId": "b8e1f80b-d70a-4078-8c78-55a451731b74"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "OK: Prepare the Acme quarterly review."
      }
    ],
    "structuredContent": {
      "event": {
        "title": "Prepare the Acme quarterly review",
        "description": "Notes for the Acme launch.",
        "location": "Notes for the Acme launch.",
        "htmlLink": "https://acme.example/brief",
        "meetLink": "https://acme.example/brief",
        "recurring": true,
        "start": "Notes for the Acme launch.",
        "end": "Notes for the Acme launch.",
        "organizer": {
          "name": "Acme",
          "self": true
        },
        "attendees": [
          {
            "email": "ada@acme.example",
            "name": "Acme",
            "status": "Notes for the Acme launch.",
            "self": true,
            "organizer": true
          }
        ],
        "selfStatus": "Notes for the Acme launch.",
        "canRsvp": true,
        "canEdit": true
      }
    }
  }
}

doers calendar get-calendar-event --calendar-id 5152790e-278e-4890-89f8-bfaa354b944e --event-id b8e1f80b-d70a-4078-8c78-55a451731b74

get_calendar_status

Whether Google Calendar is connected. configured means this deployment has a Google client, so connecting is possible. connected means the authorization has been completed. The refresh token is never returned.


Kind	Read · idempotent · no outside service
Auth	Bearer token: a personal API token (`pc_…`) or an OAuth access token (`pcat_…`)
REST	`GET https://api.doers.sh/v2/calendar`
CLI	`doers calendar get-calendar-status`
Touches	`secrets`
Operation	`getCalendarStatus`

Input

This tool takes no arguments.

Output

Output fields

Field	Type	Allowed values	Description
`configured`	boolean
`connected`	boolean

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_calendar_status",
    "arguments": {}
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Connected."
      }
    ],
    "structuredContent": {
      "configured": true,
      "connected": true
    }
  }
}

doers calendar get-calendar-status

list_calendar_events

Events in a window. Events from the chosen calendars between two instants, recurrences already expanded into their occurrences. Cancelled events are left out. Without calendarIds, only the primary calendar is read. At most 25 calendars per call. A calendar that refuses the read is skipped rather than failing the whole window: one calendar the account lost access to must not blank the day.


Kind	Read · idempotent · calls Google Calendar API
Auth	Bearer token: a personal API token (`pc_…`) or an OAuth access token (`pcat_…`)
REST	`GET https://api.doers.sh/v2/calendar/events`
CLI	`doers calendar list-calendar-events`
Touches	no table directly
Operation	`listCalendarEvents`

Input

Field	Type	Required	Allowed values	Description
`timeMin` (query)	string	yes	ISO 8601 instant	Start of the window, inclusive.
`timeMax` (query)	string	yes	ISO 8601 instant	End of the window, exclusive.
`calendarIds` (query)	string[]	no	at most 25 items	Google’s calendar id. `primary` is the account’s own.

Output

Output fields

Field	Type	Description
`connected`	boolean
`events`	object[]
`events[].id`	string	`calendarId:eventId`, unique across the window.
`events[].eventId`	string
`events[].calendarId`	string
`events[].title`	string
`events[].start`	string	RFC 3339 instant, or a date when `allDay`.
`events[].end`	string	Exclusive. A date when `allDay`.
`events[].allDay`	boolean
`events[].canEdit`	boolean	Provider-derived permission to move this occurrence.

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_calendar_events",
    "arguments": {
      "timeMin": "2026-09-22T09:30:00.000Z",
      "timeMax": "2026-09-22T09:30:00.000Z"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "1 event(s)."
      }
    ],
    "structuredContent": {
      "connected": true,
      "events": [
        {
          "id": "b8e1f80b-d70a-4078-8c78-55a451731b74",
          "eventId": "b8e1f80b-d70a-4078-8c78-55a451731b74",
          "calendarId": "5152790e-278e-4890-89f8-bfaa354b944e",
          "title": "Prepare the Acme quarterly review",
          "start": "Notes for the Acme launch.",
          "end": "Notes for the Acme launch.",
          "allDay": true,
          "canEdit": true
        }
      ]
    }
  }
}

doers calendar list-calendar-events --time-min 2026-09-22T09:30:00.000Z --time-max 2026-09-22T09:30:00.000Z

list_calendars

The calendars this account can see. The account’s calendar list, primary first and then by name. Returns an empty list with connected: false rather than an error when Google is not connected: not being connected is a state the app draws, not a failure.


Kind	Read · idempotent · calls Google Calendar API
Auth	Bearer token: a personal API token (`pc_…`) or an OAuth access token (`pcat_…`)
REST	`GET https://api.doers.sh/v2/calendar/calendars`
CLI	`doers calendar list-calendars`
Touches	no table directly
Operation	`listCalendars`

Input

This tool takes no arguments.

Output

Output fields

Field	Type	Description
`connected`	boolean
`calendars`	object[]
`calendars[].id`	string
`calendars[].name`	string
`calendars[].color`	string \| null	Google’s own colour, as a hex string.
`calendars[].primary`	boolean
`calendars[].canWrite`	boolean	Google says this account may write to the calendar.

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_calendars",
    "arguments": {}
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "- [5152790e-278e-4890-89f8-bfaa354b944e] Acme"
      }
    ],
    "structuredContent": {
      "connected": true,
      "calendars": [
        {
          "id": "5152790e-278e-4890-89f8-bfaa354b944e",
          "name": "Acme",
          "color": "#514ecb",
          "primary": true,
          "canWrite": true
        }
      ]
    }
  }
}

doers calendar list-calendars

create_calendar_event

Create an event. Creates an event in the chosen calendar. allDay sends dates rather than instants, and the end is exclusive: a single all-day event ends the following day, which is how Google models it. meet asks Google to mint a real Meet link; the response carries it. Guests are emailed only when there are guests: notifying nobody still costs a round trip.


Kind	Write · calls Google Calendar API
Auth	Bearer token: a personal API token (`pc_…`) or an OAuth access token (`pcat_…`)
REST	`POST https://api.doers.sh/v2/calendar/calendars/{calendarId}/events`
CLI	`doers calendar create-event`
Touches	no table directly
Operation	`createCalendarEvent`

Input

Field	Type	Required	Default	Allowed values	Description
`calendarId` (path)	string	yes			Google’s calendar id. `primary` is the account’s own.
`summary`	string	yes		1 to 500 characters	No description in the registry.
`start`	string	yes		ISO 8601 instant	No description in the registry.
`end`	string	yes		ISO 8601 instant	No description in the registry.
`timeZone`	string	yes			IANA zone, e.g. `Europe/Paris`.
`allDay`	boolean	no	`false`		No description in the registry.
`description`	string	no			No description in the registry.
`location`	string	no			No description in the registry.
`attendees`	string[]	no		at most 100 items, each: email address	No description in the registry.
`meet`	boolean	no	`false`		Ask Google for a Meet link.

Output

Output fields

Field	Type	Allowed values	Description
`eventId`	string \| null
`htmlLink`	string \| null
`meetLink`	string \| null

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_calendar_event",
    "arguments": {
      "calendarId": "5152790e-278e-4890-89f8-bfaa354b944e",
      "summary": "Notes for the Acme launch.",
      "start": "2026-09-22T09:30:00.000Z",
      "end": "2026-09-22T09:30:00.000Z",
      "timeZone": "Europe/Paris",
      "allDay": false,
      "description": "Notes for the Acme launch."
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "OK: event created: https://acme.example/brief."
      }
    ],
    "structuredContent": {
      "eventId": "b8e1f80b-d70a-4078-8c78-55a451731b74",
      "htmlLink": "https://acme.example/brief",
      "meetLink": "https://acme.example/brief"
    }
  }
}

doers calendar create-event 5152790e-278e-4890-89f8-bfaa354b944e "Notes for the Acme launch." --start 2026-09-22T09:30:00.000Z --end 2026-09-22T09:30:00.000Z --time-zone Europe/Paris --all-day false --description "Notes for the Acme launch."

delete_calendar_event

Delete an event. Removes the event from Google. This is not our archive: there is no undo, and the guests lose it too. An event already gone answers as a success, because the caller’s intent is satisfied.


Kind	Write · destructive · idempotent · calls Google Calendar API
Auth	Bearer token: a personal API token (`pc_…`) or an OAuth access token (`pcat_…`)
REST	`DELETE https://api.doers.sh/v2/calendar/calendars/{calendarId}/events/{eventId}`
CLI	`doers calendar delete-event`
Touches	no table directly
Operation	`deleteCalendarEvent`

Input

Field	Type	Required	Default	Description
`calendarId` (path)	string	yes		Google’s calendar id. `primary` is the account’s own.
`eventId` (path)	string	yes		Google’s event id.
`notify` (query)	boolean	no	`true`	Email the guests.

Output

Output fields

Field	Type	Allowed values	Description
`eventId`	string

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "delete_calendar_event",
    "arguments": {
      "calendarId": "5152790e-278e-4890-89f8-bfaa354b944e",
      "eventId": "b8e1f80b-d70a-4078-8c78-55a451731b74",
      "notify": true
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "OK: event deleted."
      }
    ],
    "structuredContent": {
      "eventId": "b8e1f80b-d70a-4078-8c78-55a451731b74"
    }
  }
}

doers calendar delete-event 5152790e-278e-4890-89f8-bfaa354b944e b8e1f80b-d70a-4078-8c78-55a451731b74 --notify true

disconnect_calendar

Disconnect Google Calendar. Forgets the refresh token, so nothing further can be read. Reconnecting is one authorization away: there is nothing to re-enter.


Kind	Write · destructive · idempotent · no outside service
Auth	Bearer token: a personal API token (`pc_…`) or an OAuth access token (`pcat_…`)
REST	`DELETE https://api.doers.sh/v2/calendar`
CLI	`doers calendar disconnect`
Touches	`secrets`
Operation	`disconnectCalendar`

Input

This tool takes no arguments.

Output

Output fields

Field	Type	Allowed values	Description
`connected`	boolean	`false`

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "disconnect_calendar",
    "arguments": {}
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "OK: Google Calendar disconnected."
      }
    ],
    "structuredContent": {
      "connected": false
    }
  }
}

doers calendar disconnect

move_calendar_event

Reschedule an event. Moves an event to new times: what dragging it in the calendar does. Guests are notified.


Kind	Write · idempotent · calls Google Calendar API
Auth	Bearer token: a personal API token (`pc_…`) or an OAuth access token (`pcat_…`)
REST	`PATCH https://api.doers.sh/v2/calendar/calendars/{calendarId}/events/{eventId}/schedule`
CLI	`doers calendar move-event`
Touches	no table directly
Operation	`moveCalendarEvent`

Input

Field	Type	Required	Allowed values	Description
`calendarId` (path)	string	yes		Google’s calendar id. `primary` is the account’s own.
`eventId` (path)	string	yes		Google’s event id.
`start`	string	yes	ISO 8601 instant	No description in the registry.
`end`	string	yes	ISO 8601 instant	No description in the registry.
`timeZone`	string	yes		IANA zone, e.g. `Europe/Paris`.

Output

Output fields

Field	Type	Allowed values	Description
`eventId`	string

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "move_calendar_event",
    "arguments": {
      "calendarId": "5152790e-278e-4890-89f8-bfaa354b944e",
      "eventId": "b8e1f80b-d70a-4078-8c78-55a451731b74",
      "start": "2026-09-22T09:30:00.000Z",
      "end": "2026-09-22T09:30:00.000Z",
      "timeZone": "Europe/Paris"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "OK: event rescheduled."
      }
    ],
    "structuredContent": {
      "eventId": "b8e1f80b-d70a-4078-8c78-55a451731b74"
    }
  }
}

doers calendar move-event 5152790e-278e-4890-89f8-bfaa354b944e b8e1f80b-d70a-4078-8c78-55a451731b74 --start 2026-09-22T09:30:00.000Z --end 2026-09-22T09:30:00.000Z --time-zone Europe/Paris

rename_calendar_event

Rename an event. Changes the title. Guests are notified, because the title is what they see.


Kind	Write · idempotent · calls Google Calendar API
Auth	Bearer token: a personal API token (`pc_…`) or an OAuth access token (`pcat_…`)
REST	`PATCH https://api.doers.sh/v2/calendar/calendars/{calendarId}/events/{eventId}`
CLI	`doers calendar rename-event`
Touches	no table directly
Operation	`renameCalendarEvent`

Input

Field	Type	Required	Allowed values	Description
`calendarId` (path)	string	yes		Google’s calendar id. `primary` is the account’s own.
`eventId` (path)	string	yes		Google’s event id.
`summary`	string	yes	1 to 500 characters	No description in the registry.

Output

Output fields

Field	Type	Allowed values	Description
`eventId`	string

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "rename_calendar_event",
    "arguments": {
      "calendarId": "5152790e-278e-4890-89f8-bfaa354b944e",
      "eventId": "b8e1f80b-d70a-4078-8c78-55a451731b74",
      "summary": "Notes for the Acme launch."
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "OK: event renamed."
      }
    ],
    "structuredContent": {
      "eventId": "b8e1f80b-d70a-4078-8c78-55a451731b74"
    }
  }
}

doers calendar rename-event 5152790e-278e-4890-89f8-bfaa354b944e b8e1f80b-d70a-4078-8c78-55a451731b74 "Notes for the Acme launch."

rsvp_to_calendar_event

Answer an invitation. Sets your own attendance and tells the organiser. The event is read back first so only your own line changes: Google’s attendee list is patched whole, and sending a shortened one would drop every other guest.


Kind	Write · calls Google Calendar API
Auth	Bearer token: a personal API token (`pc_…`) or an OAuth access token (`pcat_…`)
REST	`POST https://api.doers.sh/v2/calendar/calendars/{calendarId}/events/{eventId}/rsvp`
CLI	`doers calendar rsvp`
Touches	no table directly
Operation	`rsvpToCalendarEvent`

Input

Field	Type	Required	Allowed values	Description
`calendarId` (path)	string	yes		Google’s calendar id. `primary` is the account’s own.
`eventId` (path)	string	yes		Google’s event id.
`response`	string	yes	`accepted`, `declined`, `tentative`	An answer to an invitation.

Output

Output fields

Field	Type	Allowed values	Description
`eventId`	string
`response`	string	`accepted`, `declined`, `tentative`	An answer to an invitation.

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "rsvp_to_calendar_event",
    "arguments": {
      "calendarId": "5152790e-278e-4890-89f8-bfaa354b944e",
      "eventId": "b8e1f80b-d70a-4078-8c78-55a451731b74",
      "response": "accepted"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "OK: accepted."
      }
    ],
    "structuredContent": {
      "eventId": "b8e1f80b-d70a-4078-8c78-55a451731b74",
      "response": "accepted"
    }
  }
}

doers calendar rsvp 5152790e-278e-4890-89f8-bfaa354b944e b8e1f80b-d70a-4078-8c78-55a451731b74 accepted

start_calendar_auth

Begin the Google authorization. Returns the URL to open. It carries a one-time state bound to your account, which the callback checks before accepting anything: without it, a callback would accept a code obtained by somebody else.


Kind	Write · no outside service
Auth	Bearer token: a personal API token (`pc_…`) or an OAuth access token (`pcat_…`)
REST	`POST https://api.doers.sh/v2/calendar/authorize`
CLI	`doers calendar start-calendar-auth`
Touches	`secrets`
Operation	`startCalendarAuth`

Input

This tool takes no arguments.

Output

Output fields

Field	Type	Allowed values	Description
`url`	string

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "start_calendar_auth",
    "arguments": {}
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Open this to authorize: https://acme.example/brief"
      }
    ],
    "structuredContent": {
      "url": "https://acme.example/brief"
    }
  }
}

doers calendar start-calendar-auth

​get_calendar_event

​Input

​Output

​Example

​get_calendar_status

​Input

​Output

​Example

​list_calendar_events

​Input

​Output

​Example

​list_calendars

​Input

​Output

​Example

​create_calendar_event

​Input

​Output

​Example

​delete_calendar_event

​Input

​Output

​Example

​disconnect_calendar

​Input

​Output

​Example

​move_calendar_event

​Input

​Output

​Example

​rename_calendar_event

​Input

​Output

​Example

​rsvp_to_calendar_event

​Input

​Output

​Example

​start_calendar_auth

​Input

​Output

​Example

get_calendar_event

Input

Output

Example

get_calendar_status

Input

Output

Example

list_calendar_events

Input

Output

Example

list_calendars

Input

Output

Example

create_calendar_event

Input

Output

Example

delete_calendar_event

Input

Output

Example

disconnect_calendar

Input

Output

Example

move_calendar_event

Input

Output

Example

rename_calendar_event

Input

Output

Example

rsvp_to_calendar_event

Input

Output

Example

start_calendar_auth

Input

Output

Example