caldav-mcp
caldav-mcp connects an agent to any CalDAV server: calendar lists, events in a time range, plus create, update and delete.
- 111 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The agent gets the calendar account rights: reading, creating, editing and deleting events.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/caldav-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The agent gets the calendar account rights: reading, creating, editing and deleting events.
This is third-party code. Review the repository files before installing.
What it does
The server turns calendar operations into MCP tools. The agent gets a list of calendars with names and absolute URLs, reads events between two ISO 8601 dates and creates new ones: regular or all-day, with a description, location and recurrence rule. Existing events are edited selectively: only the supplied fields change. Deletion goes by the event UID. The connection takes three environment variables: the CalDAV server URL, a username and a password.
Who it is for. People who keep a calendar on a CalDAV server such as Nextcloud or Radicale and want an agent to schedule meetings.
Good fit when
- An agent finds a free slot next week from the event list.
- A weekly meeting has to appear in the calendar with a recurrence rule.
- A one-day all-day event must be created in a single request.
- Moving a meeting means changing only the time while other fields stay put.
Not a fit when
- The calendar runs only on a closed protocol without CalDAV.
- The calendar password must not be handed to a process on your machine.
- You need tasks or contacts: the server works with calendar events only.
Example request
Show my events for tomorrow and add a one-hour meeting called Planning on Friday at 3 pm.MCP
- Transport
- stdio
- Authentication
- API key
Environment variables
CALDAV_BASE_URLrequired- CalDAV server URL.
CALDAV_USERNAMErequired- Calendar username.
CALDAV_PASSWORDrequired, secret- Calendar password or app password.
Limitations
It needs access to a CalDAV server: the URL, username and password go in `CALDAV_BASE_URL`, `CALDAV_USERNAME` and `CALDAV_PASSWORD`. The password lives only in the process environment, but the agent gets the rights of that account: it sees every calendar and can edit and delete events. To change or delete an event the agent needs the calendar URL and the event ID, which it takes from the list results.
How to disable. Remove the `calendar` entry from MCP configuration. If the password was created for the agent, revoke it on the calendar server.
FAQ
How do I connect caldav-mcp?
Add an MCP server with the command `npx` and the argument `caldav-mcp`, and put `CALDAV_BASE_URL`, `CALDAV_USERNAME` and `CALDAV_PASSWORD` in the environment.
Which tools does the server expose?
`list-calendars`, `list-events`, `create-event`, `update-event` and event deletion by UID.
Are recurring events supported?
Yes. `create-event` and `update-event` take a `recurrenceRule` with frequency `DAILY`, `WEEKLY`, `MONTHLY` or `YEARLY`, an interval, a count and an end date.
How do I create an all-day event?
Pass `wholeDay: true` with start and end on the same calendar day. The timestamps need not be identical.
What does editing an event need?
The `calendarUrl` and the event ID. The agent takes both from `list-calendars` and `list-events`.
Discussion
No questions or reviews yet.
Related
MCP serversMCP server for the macOS calendar: an agent creates, finds and edits events in natural language
Yandex Calendar MCP server over CalDAV
yandex-calendar-mcp
A Yandex Calendar MCP server over CalDAV: reading the schedule, creating and editing events, invitations with real email delivery
Yandex Calendar MCP server
Яндекс Календарь MCP для Claude
An MCP server for Yandex Calendar: view, create and delete events using an app password
A self-hosted scheduler with a built-in MCP server: an agent checks slots, books, reschedules and cancels calls.
Google Calendar MCP Server: calendar for Claude
Google Calendar MCP Server
A calendar MCP for Claude Desktop: the agent views, creates, updates and deletes Google Calendar events, recurring ones included
Yandex Calendar MCP with a setup CLI
yandex-mcp workspace
A Yandex Calendar MCP server over CalDAV with a separate CLI for setup and app-password verification
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| caldav-mcp (this card) | no | API key | 111 | |
| Google Calendar MCP Server: calendar for Claude | no | OAuth | 59 | a Google Calendar server; caldav-mcp works with any CalDAV server |
| A simple Yandex Calendar MCP server | no | API key | 0 | MCP for Yandex Calendar; here the generic CalDAV protocol |
README in short
A small TypeScript project under the MIT licence. The README lists the features, gives MCP client configuration and a tool reference generated by a script.