List events
Events of one calendar between two dates, oldest first.
MCP tool nextcloud_read → list_events
read
Returns the events of one calendar that fall in the time range, oldest first, with title, start, end, location and all-day flag. Use it before creating an event to find overlaps.
Parameters
| Name | Type | Description |
|---|---|---|
| calendar string required | string | Calendar from list_calendars. |
| from datetime required | datetime | Start of the range. |
| to datetime required | datetime | End of the range. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "nextcloud_read",
"arguments": {
"operation": "list_events",
"arguments": {
"calendar": "calendar",
"from": "2026-10-01T09:00:00Z",
"to": "2026-10-01T09:00:00Z"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"events": [
{
"event_id": "a41c0d7e-5b2f-4c1a-9e20-77d3f0b6c812",
"title": "Acme kickoff",
"start": "2026-10-21T10:00:00+02:00",
"end": "2026-10-21T11:00:00+02:00",
"location": "Video call",
"all_day": false
}
]
},
"isError": false
}