← All MCP tools

List calendar events

list_calendar_events
Read-only

What it does

List the human's cached calendar events (title, time, location, organiser, attendees) from their connected Google accounts. Defaults to a fortnight either side of today. Use it to see what a meeting actually is before deciding which task it belongs to. Empty when no Google account is connected — that is a setup gap, not an error.

Parameters

NameTypeRequiredDescription
fromstringOptional

Earliest local date, YYYY-MM-DD

tostringOptional

Latest local date, YYYY-MM-DD

limitnumberOptional

Annotations

The hints the server sends with this tool. A host reads them to decide whether to ask you before a call.

Read-onlyreadOnlyHint: true
Changes nothing.
DestructivedestructiveHint: false
Only adds or reads; nothing already there is removed or overwritten.
IdempotentidempotentHint: —
Doesn't apply: the tool changes nothing.
Open worldopenWorldHint: false
Touches only your own Done account.

Which tokens can call it

A connection made with OAuth has full access. A token from Settings → Agent access → Extra MCP tokens can be narrowed, and a narrowed token never sees beyond its project or workspace.

  • Full accessAllowed
  • Read-only tokenAllowed
  • Single-project tokenRefused
  • Single-workspace tokenRefused

Try it

With Done connected, ask your assistant something like:

“What's on my calendar this week?”

Connect Done to your assistant

One MCP endpoint per account, over OAuth or a token. Step-by-step setup for each client:

MCP setup overview →