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 }'

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: ❌