Skip to main content
Glama
lukegskw

CalDAV MCP Server

by lukegskw
OverviewSchemaRelated ServersScoreDiscussions(2)
TypeScript
Remote

List calendar events

list_events
Read-onlyIdempotent

Find events overlapping a start and end time, with recurring series expanded into individual occurrences. Fetch more results using the provided cursor.

Instructions

List events that overlap the start-inclusive, end-exclusive interval and expand recurring series into occurrences, across at most 366 days. Use list_calendars first to obtain calendar_id and use get_event instead for one known event. Continue with next_cursor and unchanged query filters when more results are available.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
endYesExclusive end of the event search interval; must be after start and no more than 366 days later.
limitNoMaximum events to return in this page, from 1 to 500; defaults to 100.
startYesInclusive start of the event search interval as an ISO 8601 instant.
cursorNoOpaque next_cursor from the preceding page. Reuse it with the same calendar, interval, and timezone.
timezoneNoFallback IANA timezone used when an event lacks timezone metadata during recurrence expansion.
calendar_idYesOpaque calendar ID returned by list_calendars.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
eventsYesEvents in deterministic chronological order for this page.
next_cursorYesOpaque cursor for the next page, or null when this is the last page.

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Changed18 schema fields changedv0.1.7
    • changedInput schema / properties / end / pattern
      Previous value: -"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"New value: +"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
    • changedInput schema / properties / start / pattern
      Previous value: -"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"New value: +"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
    • removedOutput schema / properties / events / items / properties / alarms / items / properties / description / anyOf
      Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / events / items / properties / alarms / items / properties / description / type
      Added value: +[
+  "string",
+  "null"
+]
    • removedOutput schema / properties / events / items / properties / alarms / items / properties / uid / anyOf
      Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / events / items / properties / alarms / items / properties / uid / type
      Added value: +[
+  "string",
+  "null"
+]
    • removedOutput schema / properties / events / items / properties / description / anyOf
      Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / events / items / properties / description / type
      Added value: +[
+  "string",
+  "null"
+]
    • removedOutput schema / properties / events / items / properties / etag / anyOf
      Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / events / items / properties / etag / type
      Added value: +[
+  "string",
+  "null"
+]
    • removedOutput schema / properties / events / items / properties / location / anyOf
      Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / events / items / properties / location / type
      Added value: +[
+  "string",
+  "null"
+]
    • removedOutput schema / properties / events / items / properties / recurrence_id / anyOf
      Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / events / items / properties / recurrence_id / type
      Added value: +[
+  "string",
+  "null"
+]
    • removedOutput schema / properties / events / items / properties / rrule / anyOf
      Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / events / items / properties / rrule / type
      Added value: +[
+  "string",
+  "null"
+]
    • removedOutput schema / properties / next_cursor / anyOf
      Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / next_cursor / type
      Added value: +[
+  "string",
+  "null"
+]
  2. Changed31 schema fields changedv0.1.1
    • addedInput schema / properties / calendar_id / description
      Added value: +"Opaque calendar ID returned by list_calendars."
    • addedInput schema / properties / cursor / description
      Added value: +"Opaque next_cursor from the preceding page. Reuse it with the same calendar, interval, and timezone."
    • addedInput schema / properties / end / description
      Added value: +"Exclusive end of the event search interval; must be after start and no more than 366 days later."
    • addedInput schema / properties / limit / description
      Added value: +"Maximum events to return in this page, from 1 to 500; defaults to 100."
    • addedInput schema / properties / start / description
      Added value: +"Inclusive start of the event search interval as an ISO 8601 instant."
    • addedInput schema / properties / timezone / description
      Added value: +"Fallback IANA timezone used when an event lacks timezone metadata during recurrence expansion."
    • addedOutput schema / properties / events / description
      Added value: +"Events in deterministic chronological order for this page."
    • addedOutput schema / properties / events / items / properties / alarms / description
      Added value: +"Normalized alarms attached to the event."
    • addedOutput schema / properties / events / items / properties / alarms / items / description
      Added value: +"A normalized alarm returned by iCloud Calendar."
    • addedOutput schema / properties / events / items / properties / alarms / items / properties / action / description
      Added value: +"Stored iCalendar alarm action."
    • addedOutput schema / properties / events / items / properties / alarms / items / properties / description / description
      Added value: +"Stored alarm notification text, when available."
    • addedOutput schema / properties / events / items / properties / alarms / items / properties / minutes_before / description
      Added value: +"Whole minutes before event start, when representable."
    • addedOutput schema / properties / events / items / properties / alarms / items / properties / uid / description
      Added value: +"Stored alarm UID, when available."
    • addedOutput schema / properties / events / items / properties / calendar_id / description
      Added value: +"Opaque ID of the containing calendar."
    • addedOutput schema / properties / events / items / properties / description / description
      Added value: +"Stored event notes."
    • changedOutput schema / properties / events / items / properties / end / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "date_time": {
-        "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:Z|[+-]\\d{2}:\\d{2})$",
-        "type": "string"
-      },
-      "timezone": {
-        "maxLength": 4096,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "date_time",
-      "timezone"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "date": {
-        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-        "type": "string"
-      }
-    },
-    "required": [
-      "date"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "description": "A stored timed calendar value.",
+    "properties": {
+      "date_time": {
+        "description": "Stored ISO 8601 date-time with seconds and an explicit UTC offset or Z.",
+        "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:Z|[+-]\\d{2}:\\d{2})$",
+        "type": "string"
+      },
+      "timezone": {
+        "description": "IANA timezone associated with the stored date-time.",
+        "maxLength": 4096,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "date_time",
+      "timezone"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "description": "An all-day calendar value.",
+    "properties": {
+      "date": {
+        "description": "Calendar date in YYYY-MM-DD format.",
+        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "date"
+    ],
+    "type": "object"
+  }
+]
    • addedOutput schema / properties / events / items / properties / end / description
      Added value: +"Normalized event end."
    • addedOutput schema / properties / events / items / properties / etag / description
      Added value: +"Current ETag for optimistic concurrency, when available."
    • addedOutput schema / properties / events / items / properties / href / description
      Added value: +"Redacted fingerprint of the CalDAV resource URL."
    • addedOutput schema / properties / events / items / properties / location / description
      Added value: +"Stored event location."
    • addedOutput schema / properties / events / items / properties / raw_ical / description
      Added value: +"Raw iCalendar resource, included only when explicitly requested."
    • addedOutput schema / properties / events / items / properties / recurrence_exception / description
      Added value: +"Whether this result is an overridden recurrence instance."
    • addedOutput schema / properties / events / items / properties / recurrence_id / description
      Added value: +"Occurrence identifier for an expanded recurring event."
    • addedOutput schema / properties / events / items / properties / recurring / description
      Added value: +"Whether this event belongs to a recurring series."
    • addedOutput schema / properties / events / items / properties / resource_id / description
      Added value: +"Opaque event ID accepted by get_event, update_event, and delete_event."
    • addedOutput schema / properties / events / items / properties / rrule / description
      Added value: +"Stored RFC 5545 recurrence rule without the RRULE: prefix."
    • changedOutput schema / properties / events / items / properties / start / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "date_time": {
-        "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:Z|[+-]\\d{2}:\\d{2})$",
-        "type": "string"
-      },
-      "timezone": {
-        "maxLength": 4096,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "date_time",
-      "timezone"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "date": {
-        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-        "type": "string"
-      }
-    },
-    "required": [
-      "date"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "description": "A stored timed calendar value.",
+    "properties": {
+      "date_time": {
+        "description": "Stored ISO 8601 date-time with seconds and an explicit UTC offset or Z.",
+        "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:Z|[+-]\\d{2}:\\d{2})$",
+        "type": "string"
+      },
+      "timezone": {
+        "description": "IANA timezone associated with the stored date-time.",
+        "maxLength": 4096,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "date_time",
+      "timezone"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "description": "An all-day calendar value.",
+    "properties": {
+      "date": {
+        "description": "Calendar date in YYYY-MM-DD format.",
+        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "date"
+    ],
+    "type": "object"
+  }
+]
    • addedOutput schema / properties / events / items / properties / start / description
      Added value: +"Normalized event start."
    • addedOutput schema / properties / events / items / properties / summary / description
      Added value: +"Stored event title."
    • addedOutput schema / properties / events / items / properties / uid / description
      Added value: +"Stored iCalendar UID."
    • addedOutput schema / properties / next_cursor / description
      Added value: +"Opaque cursor for the next page, or null when this is the last page."
  3. First observedv0.1.0

TDQS

A4.9/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already indicate read-only, idempotent, non-destructive behavior, and the description adds substantial behavioral context: interval inclusivity, recurring series expansion, the 366-day maximum, and pagination continuation. This goes well beyond the structured annotation data and discloses important operation semantics.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two dense sentences cover core behavior, prerequisites, alternative selection, and pagination without repetition or filler. The most critical semantic details are front-loaded, and every clause carries operational value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a paginated list operation with six parameters and an output schema, the description covers the required workflow (list_calendars, get_event), recurrence behavior, interval constraints, and pagination instructions. The output schema handles return-value details, and annotations cover the safety profile, so nothing essential is missing from the description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3. The description adds value on top by explaining that calendar_id comes from list_calendars, that cursor must be reused with unchanged query filters, and that interval boundaries are inclusive/exclusive. This helps agents understand how the parameters relate to workflow even though the schema already documents each field.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb and resource ('List events') and defines precise interval semantics ('start-inclusive, end-exclusive') plus recurrence expansion. It also differentiates from related tools by saying to use 'get_event instead for one known event' and to use 'list_calendars first'. An agent can clearly understand what this tool does and how it differs from siblings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives explicit workflow guidance: call list_calendars first for calendar_id, use get_event for a single known event, and paginate with next_cursor using unchanged filters. This directly tells the agent when to use this tool versus alternatives and how to handle multi-page results.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/lukegskw/caldav-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server