List Calendars: View all available calendars.
List Events:
- Filter by specific calendar or search globally across all calendars.
- Filter by time range (start/end date).
Manage Events:
- Create new events.
- Update existing events.
- Delete events.

Prerequisites

Python 3.14 or higher
uv (Universal Python Package Manager)

Installation

Clone the repository:

git clone <repository_url>
cd MCP-CalDAV

Install dependencies:
```
uv sync
```

Configuration

Create a .env file in the root directory with your CalDAV credentials:

CALDAV_URL=http://your-server:port/dav.php
CALDAV_USERNAME=YourUsername
CALDAV_PASSWORD=YourPassword

Usage

Running Manually

You can run the server directly using uv. It communicates via standard input/output (stdio), so running it directly in a terminal will just wait for input.

uv run src/server.py

Configuring an MCP Client

To use this with an MCP client (like Claude Desktop or another MCP-compatible app), add the following configuration to your client's settings (e.g., claude_desktop_config.json):

{
  "mcpServers": {
    "caldav": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Users\\LagoWorkStation\\OneDrive\\Documentos\\MCP-CalDAV",
        "run",
        "src/server.py"
      ]
    }
  }
}

Note: Adjust the absolute path to point to your project directory.

Available Tools

list_calendars()
- Returns a list of all calendars the user has access to.
list_events(calendar_name=None, start_date=None, end_date=None)
- Lists events.
- calendar_name (optional): Name of the calendar. If omitted, searches ALL calendars.
- start_date (optional): Start of the range (YYYY-MM-DD or ISO).
- end_date (optional): End of the range.
create_event(calendar_name, summary, start_time, end_time, description="")
- Creates an event.
update_event(calendar_name, event_uid, summary=None, start_time=None, end_time=None, description=None)
- Updates an event by UID.
delete_event(calendar_name, event_uid)
- Deletes an event by UID.