caldav-mcp
@dominik1001
🗓️ A CalDAV Model Context Protocol (MCP) server to expose calendar operations as tools for AI assistants.
概要
What is caldav-mcp?
caldav-mcp is a Model Context Protocol (MCP) server that exposes CalDAV calendar and task operations as tools for AI assistants. It connects to any standard CalDAV server and allows AI agents to list, create, update, and delete events and tasks.
How to use caldav-mcp?
Run it via npx caldav-mcp and configure it by setting the CALDAV_BASE_URL, CALDAV_USERNAME, and CALDAV_PASSWORD environment variables in your MCP client configuration (e.g., in the mcpServers section).
Key features of caldav-mcp
- Connect to any standard CalDAV server
- List, create, update, and delete calendar events
- List, create, update, complete, and delete tasks (VTODOs)
- Support for recurring events via recurrence rules
- Filter tasks by status, due date, and paginate results
Use cases of caldav-mcp
- An AI assistant managing a user’s calendar by creating, updating, or deleting events
- A productivity bot that reads and organizes tasks from a CalDAV to-do list
- Automating meeting scheduling by listing free time slots and creating events
FAQ from caldav-mcp
What CalDAV servers does caldav-mcp support?
It connects to any standard CalDAV server using the provided base URL, username, and password.
How do I configure caldav-mcp?
Set the environment variables CALDAV_BASE_URL, CALDAV_USERNAME, and CALDAV_PASSWORD in your MCP client configuration.
Does caldav-mcp support tasks (todos)?
Yes, it provides tools for listing, creating, updating, completing, and deleting VTODO tasks.
Are there limits on returned data?
The list-todos tool has a default limit of 50 and a maximum of 500 tasks. No explicit limit is documented for list-events.
What authentication does caldav-mcp use?
It uses HTTP Basic Authentication with the provided username and password.
