# list_calendar

> List the calendar with Wavegrain's MCP server: the list_calendar tool needs the read permission. Inputs, outputs and an example call.

> Index of these docs: https://wavegrain.com/developers/llms.txt

**List the calendar.** Permission: `read`. Read-only: changes nothing.

Scheduled slideshows, slideshows already sent, and automation runs, each with its local time, status, review state and each network's post state, between two ISO date-times, at most 100 days apart; by default the next 14 days. To shift every planned post in a window by some days, use move_scheduled.

## Inputs

| Input | Type | Required | Notes |
| --- | --- | --- | --- |
| `from` | string | no | Start of the window. Default: now. |
| `to` | string | no | End of the window, at most 100 days after from. Default: 14 days after from. |

The fields inside an object or a list are in the JSON Schema at [/developers/mcp-tools.json](/developers/mcp-tools.json).

## Returns

| Field | Type | Notes |
| --- | --- | --- |
| `entries` | object[] | Every entry in the window, earliest first. |

## Example call

Send it to `POST https://wavegrain.com/api/mcp` with an access key that has the `read` permission; [Authentication](/developers/authentication) shows how to make one.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_calendar",
    "arguments": {}
  }
}
```

## Related tools

- [`get_format`](/developers/mcp-tools/get_format): Get a slideshow format
- [`list_slideshows`](/developers/mcp-tools/list_slideshows): List slideshows
- [`get_slideshow`](/developers/mcp-tools/get_slideshow): Get a slideshow
- [`list_collections`](/developers/mcp-tools/list_collections): List image collections
- [`list_collection_images`](/developers/mcp-tools/list_collection_images): List a collection's images
- [`get_credits`](/developers/mcp-tools/get_credits): Get credits
- [All 79 tools](/developers/mcp-tools)
