# Free/Busy Query

Google Calendar

Check busy intervals across connected Google calendars without reading event details.

## 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 Free/Busy Query (tool ID: google-calendar.free-busy). 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**

Returns busy intervals for up to 50 calendars in a bounded time range without exposing event titles or descriptions. Always one $0.0025 request.

**Inputs and outputs**

### Input

`body` object · required

Bounded request body sent to the connected application.

### Output

`calendars` object

Returned calendars value.

`kind` string

Returned kind value.

`timeMax` string

Returned time max value.

`timeMin` string

Returned time min 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.free-busy",
  "input": {
    "body": {
      "items": [
        {
          "id": "YOUR-GOOGLE-CALENDAR-ID"
        }
      ],
      "timeMax": "2026-08-25T17:00:00Z",
      "timeMin": "2026-08-25T09:00:00Z",
      "timeZone": "Europe/London"
    }
  }
}
```

### Output

```
{
  "kind": "calendar#freeBusy",
  "timeMax": "2026-08-17T17:00:00.000Z",
  "timeMin": "2026-08-17T09:00:00.000Z",
  "calendars": {
    "primary": {
      "busy": [
        {
          "end": "2026-08-17T10:30:00Z",
          "start": "2026-08-17T10:00:00Z"
        }
      ]
    }
  }
}
```

**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/free-busy