# Calendar view

> The posting calendar day by day: scheduled posts, open slots and best times, for up to 42 days.

`scheduler.schedule_view` · read

- **MCP tool:** `scheduler_schedule_view`. Catalog: reach it with `find_actions` and `run_read_action`, or turn on the full toolset.
- **REST:** `GET /v1/scheduler/schedule-view`
- **CLI:** `xholic scheduler schedule-view`
- **Scope:** `read`
- **Plan:** Every plan, including the trial
- **Cost:** Free.
- **Rate limit bucket:** `read`

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `tagIds` | string ≤ 1900 chars | No | Comma-separated tag ids from list_tags, to show only posts with those tags. |
| `timezone` | string ≤ 100 chars | No | IANA timezone such as America/New_York. Use the user's timezone. |
| `days` | integer 1–42 | No | Days to show (default 21). |
| `startDate` | string (date) | No | First day, YYYY-MM-DD. Defaults to today. |
| `account` | string ≤ 64 chars | No | X account to act on, as @handle. Leave it out to use the connection's default account. |
