caldav

This CalDAV MCP server exposes calendar operations as AI-friendly tools. The available tools include create-event for creating new calendar events, list-events for retrieving events within a specified timeframe from a given calendar URL, delete-event for removing events by their UID, and list-calendars for enumerating all calendars accessible via the configured CalDAV server. To use, ensure your MCP configuration points to your CalDAV endpoint and provide credentials via environment variables. Then invoke the tools through your MCP-compatible assistant to perform calendar operations, and the responses will include relevant event details (e.g., uid, summary, start, end) or confirmation messages as appropriate. For example, you can call list-events with a start and end time to fetch events within that window, or create-event with a summary, start, and end time to schedule a new event. The delete-event tool requires the event UID obtained from a prior list-events response.

Prerequisites:

• Node.js (LTS) and npm installed on your machine
• Access to the MCP server environment where you intend to run the service

Installation steps:

1. Install the package (assuming you’re using npm and the repository is published as caldav-mcp):

npm install -g caldav-mcp

2. Configure your environment by setting CALDAV_BASE_URL, CALDAV_USERNAME, and CALDAV_PASSWORD with your CalDAV server credentials. You can set them in a .env file or your runtime environment.
3. Run the MCP server in development/production mode depending on your setup. A typical run uses npx as shown in the configuration:

npx caldav-mcp

4. (Optional) For development, you can run in watch mode if supported by the package, or build from source if you clone the repo and install dependencies locally.

Basic verification:

• Ensure the MCP server starts and exposes the calendar tools (create-event, list-events, delete-event, list-calendars).
• Test with suitable CalDAV credentials to confirm operations succeed.

Notes and tips:

• Ensure CALDAV_BASE_URL points to the correct CalDAV server and that the credentials have the necessary permissions.
• If your CalDAV server uses self-signed certificates, you may need to configure TLS settings or adjust your environment to trust the certificate.
• When using list-events, provide a realistic start and end datetime in a supported ISO-8601 format.
• The create-event tool requires a valid start and end time; ensure end is after start. The returned UID is needed for subsequent delete-event calls.
• If you encounter authentication errors, double-check the provided CALDAV_USERNAME and CALDAV_PASSWORD and verify network access to CALDAV_BASE_URL.
• In production, consider securing environment variables and using a secret management solution.
• This MCP server relies on the underlying CalDAV access; ensure network access and server compatibility with your CalDAV provider.