`gcal_list_calendars`

Pack: google_calendar · Endpoint: https://gateway.pipeworx.io/google_calendar/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/gcal_list_calendars for the schema, then POST the same URL with its arguments for the data.

List all accessible calendars. Returns calendar IDs, names, time zones, and your access level for each. Use to identify which calendar to query or modify.

Example call

Arguments

{}

curl

curl -X POST https://gateway.pipeworx.io/google_calendar/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"gcal_list_calendars","arguments":{}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('gcal_list_calendars', {});

Response shape

Field	Type	Description
`kind`	string	Resource kind identifier
`etag`	string	ETag of the resource
`items`	array	List of calendars
`error`	string	Error code if connection failed
`message`	string	Error message if connection failed

Full JSON Schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "description": "Resource kind identifier"
    },
    "etag": {
      "type": "string",
      "description": "ETag of the resource"
    },
    "items": {
      "type": "array",
      "description": "List of calendars",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "description": "Calendar resource kind"
          },
          "etag": {
            "type": "string",
            "description": "Calendar ETag"
          },
          "id": {
            "type": "string",
            "description": "Calendar ID"
          },
          "summary": {
            "type": "string",
            "description": "Calendar name"
          },
          "description": {
            "type": "string",
            "description": "Calendar description"
          },
          "timeZone": {
            "type": "string",
            "description": "Calendar time zone"
          },
          "accessRole": {
            "type": "string",
            "enum": [
              "owner",
              "writer",
              "reader",
              "freeBusyReader"
            ],
            "description": "User's access level"
          },
          "primary": {
            "type": "boolean",
            "description": "Whether this is the primary calendar"
          },
          "defaultReminders": {
            "type": "array",
            "description": "Default reminders",
            "items": {
              "type": "object",
              "properties": {
                "method": {
                  "type": "string",
                  "description": "Reminder method"
                },
                "minutes": {
                  "type": "number",
                  "description": "Minutes before event"
                }
              }
            }
          }
        }
      }
    },
    "error": {
      "type": "string",
      "description": "Error code if connection failed"
    },
    "message": {
      "type": "string",
      "description": "Error message if connection failed"
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "google_calendar": {
      "url": "https://gateway.pipeworx.io/google_calendar/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

gcal_list_calendars