CalDAV MCP Server
A TypeScript MCP server for iCloud Calendar with native multi-VALARM support.
Connector by lukegskw · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/lukegskw-caldav-mcp
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.
- Tools
- 3 read · 1 write · 2 delete
- Secrets
- 1 (API keys, tokens or passwords)
- Install scripts
- None found
- Runs as
- Node.js package
Tools by what they do 6
Read from the source code; the running server may list different tools.
Read 3 · Look things up without changing anything.
get_eventlist_calendarslist_events
Write 1 · Create, change, send or run things.
create_event
Delete 2 · Delete, drop, revoke or wipe things.
delete_eventupdate_event
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
CALDAV_PASSWORD
Other settings (environment variables or headers).
CALDAV_USERNAME
Network hosts it talks to 5
apple.com· found in codecaldav.icloud.com· found in codegithub.com· found in codeglama.ai· found in codesupport.apple.com· found in code
Tools (6)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
create_eventCreate calendar eventCreate a new event in a writable iCloud calendar and return the stored representation; existing events are not changed. Use list_calendars first to obtain calendar_id, and use update_event when the event already exists. Timed values require matching offsets and timezones, all-day end dates are exclusive, recurrence rules omit the RRULE: prefix, and travel_minutes sets Apple Calendar travel time for timed events.
delete_eventDelete calendar eventcan change or delete dataPermanently delete an event or entire recurring series; individual expanded occurrences are not supported. Target it by resource_id or by calendar_id with uid, and supply expected_etag when available to prevent deleting a concurrently changed event.
get_eventGet calendar eventread-onlyRead one event by resource_id, preferably from a previous result, or by the calendar_id and uid pair. Use list_events for range searches. Request raw iCalendar only for controlled diagnostics because it may contain sensitive calendar data.
list_calendarsList calendarsread-onlyList calendars available in the configured iCloud account. Use this first to obtain the opaque calendar_id required by list_events and create_event; writable is a best-effort capability indicator.
list_eventsList calendar eventsread-onlyList 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.
update_eventUpdate calendar eventcan change or delete dataModify an existing event or entire recurring series; individual expanded occurrences are not supported. Target it by resource_id or by calendar_id with uid. Omitted patch fields are preserved, null clears nullable fields, an empty alarms array removes alarms, and expected_etag can prevent a stale write.
Signals
- Stars
- 5
- Forks
- 3
- Open issues
- 0
- Weekly downloads
- 131
- Last commit
- Oct 21, 2026 (7 days ago)
- Last release
- Oct 21, 2026 (7 days ago)
- Last package publish
- Oct 21, 2026 (7 days ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.lukegskw/caldav-mcp- Version
- 0.2.0
- Auth
- API key
- Packages
- oci
ghcr.io/lukegskw/caldav-mcp:0.2.0npm @lukegskw/caldav-mcp - License
- MIT
- Repository
- github.com/lukegskw/caldav-mcp
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
CalDAV MCP Server. Agent Mart. https://agentmart.dev/connectors/lukegskw-caldav-mcp (last updated 2026-10-24)