# Events List

Google Calendar

List and search events in a bounded range on a connected Google calendar.

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Events List (tool ID: google-calendar.events-list). Ask me for the details you need, then show me the result. Help me connect the required app account if needed.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

This tool also needs you to connect your app account.

Connect your first agent to receive $1 trial credit.

**Job:** [Manage Google Calendar events](https://scrollport.com/tools/google-calendar-mcp)

**Current price:** $0.0025/request

**Availability:** Requires connected account

## Tool details

**About this tool**

Lists a bounded date range of events from one Google calendar, with optional text and property filters. Deleted events are excluded from the launch surface. Each response page is one $0.0025 request.

**Inputs and outputs**

### Input

`max_pages` integer · optional

Maximum number of result pages to request.

minimum: 1 · maximum: 10

`path` object · required

Identifier path for the authorised connected-app record.

`query` object · optional

Search terms used to find relevant records.

### Output

`pages` number

Returned pages value.

`results` array

Returned results value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "google-calendar.events-list",
  "input": {
    "path": {
      "calendarId": "YOUR-GOOGLE-CALENDAR-ID"
    },
    "query": {
      "orderBy": "startTime",
      "timeMax": "2026-08-26T00:00:00Z",
      "timeMin": "2026-08-25T00:00:00Z",
      "maxResults": 10,
      "singleEvents": true
    },
    "max_pages": 1
  }
}
```

### Output

```
{
  "pages": 1,
  "results": [
    {
      "id": "scrollport-verification-event",
      "end": {
        "dateTime": "2026-08-17T10:30:00+01:00",
        "timeZone": "Europe/London"
      },
      "kind": "calendar#event",
      "start": {
        "dateTime": "2026-08-17T10:00:00+01:00",
        "timeZone": "Europe/London"
      },
      "status": "confirmed",
      "created": "2026-08-15T12:00:00.000Z",
      "creator": {
        "self": true,
        "email": "user@example.com"
      },
      "iCalUID": "scrollport-verification-event@google.com",
      "summary": "Review launch plan",
      "updated": "2026-08-15T12:05:00.000Z",
      "htmlLink": "https://calendar.google.com/calendar/event?eid=scrollport-verification-event",
      "location": "Video call",
      "sequence": 0,
      "organizer": {
        "self": true,
        "email": "user@example.com"
      },
      "description": "Purpose-made Scrollport verification event. Safe to edit.",
      "conferenceData": {
        "entryPoints": [
          {
            "uri": "https://meet.google.com/abc-defg-hij",
            "label": "meet.google.com/abc-defg-hij",
            "entryPointType": "video"
          }
        ],
        "conferenceId": "abc-defg-hij",
        "conferenceSolution": {
          "key": {
            "type": "hangoutsMeet"
          },
          "name": "Google Meet"
        }
      }
    }
  ]
}
```

**Errors and limitations**

- `connection_required`: This capability acts on your own Google Calendar, which isn't connected yet.Open connect_url, approve Google Calendar event and calendar-list access, then retry this run unchanged.

---

Canonical page: https://scrollport.com/tools/providers/google-calendar/events-list