MCP Tools Reference: calendarmcp.googleapis.com

Tool: list_calendars

Returns the calendars on the user's calendar list.

Use this tool for queries like:

  • What are all my calendars?

Example:

list_calendars()
        # Returns all calendars the authenticated user has access to.

The following sample demonstrate how to use curl to invoke the list_calendars MCP tool.

Curl Request 
curl --location 'https://calendarmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_calendars",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Input Schema

ListCalendarsRequest

JSON representation 
{

  "pageSize": integer

  "pageToken": string
}
Fields

Union field _page_size.

_page_size can be only one of the following:
pageSize

integer

Optional. Maximum number of entries returned on one result page. By default the value is 100 entries. The page size can never be larger than 250 entries.

Union field _page_token.

_page_token can be only one of the following:
pageToken

string

Optional. Token specifying which result page to return.

Output Schema

ListCalendarsResponse

JSON representation 
{
  "calendars": [
    {
      object (Calendar)
    }
  ],

  "nextPageToken": string
}
Fields
calendars[]

object (Calendar)

List of calendars on the calendar list.

Union field _next_page_token.

_next_page_token can be only one of the following:
nextPageToken

string

Token used to access the next page of this result. Omitted if no further results are available.

Calendar

JSON representation 
{
  "id": string,
  "summary": string,
  "description": string,
  "timeZone": string
}
Fields
id

string

Identifier. Identifier of the calendar.
summary

string

Title of the calendar. Read-only.
description

string

Description of the calendar. Optional. Read-only.
timeZone

string

The time zone of the calendar. Optional. Read-only.

Tool Annotations

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌