# caldav-mcp

Connects CalDAV accounts to AI assistants to list, schedule, and update calendar events alongside VTODO task lists directly from your workspace.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 105
- Author: dominik1001
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dominik1001/caldav-mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/caldav-mcp

## What it does

This server bridges the CalDAV protocol to MCP tools. The workflow starts with `list-calendars`, which yields calendar names and absolute URLs. That URL feeds into subsequent tools to inspect events inside a time range, create appointments with recurrence rules, or remove items by UID.

The toolset also covers VTODO task management. You can pull open items with pagination ranging between 50 and 500 records, schedule new todos with deadlines, and update task statuses.

Running the server requires three environment variables: `CALDAV_BASE_URL`, `CALDAV_USERNAME`, and `CALDAV_PASSWORD`. Without valid authentication details, requests to your CalDAV host fail immediately.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `CALDAV_BASE_URL`, `CALDAV_USERNAME`, `CALDAV_PASSWORD` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add caldav-mcp -e CALDAV_BASE_URL=<CALDAV_BASE_URL> -e CALDAV_USERNAME=<CALDAV_USERNAME> -e CALDAV_PASSWORD=<CALDAV_PASSWORD> -- npx -y caldav-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add caldav-mcp --env CALDAV_BASE_URL=<CALDAV_BASE_URL> --env CALDAV_USERNAME=<CALDAV_USERNAME> --env CALDAV_PASSWORD=<CALDAV_PASSWORD> -- npx -y caldav-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "caldav-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "caldav-mcp"
            ],
            "env": {
                "CALDAV_BASE_URL": "<CALDAV_BASE_URL>",
                "CALDAV_USERNAME": "<CALDAV_USERNAME>",
                "CALDAV_PASSWORD": "<CALDAV_PASSWORD>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "caldav-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "caldav-mcp"
            ],
            "env": {
                "CALDAV_BASE_URL": "<CALDAV_BASE_URL>",
                "CALDAV_USERNAME": "<CALDAV_USERNAME>",
                "CALDAV_PASSWORD": "<CALDAV_PASSWORD>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e CALDAV_BASE_URL=<CALDAV_BASE_URL> -e CALDAV_USERNAME=<CALDAV_USERNAME> -e CALDAV_PASSWORD=<CALDAV_PASSWORD> caldav-mcp npx -y caldav-mcp
```
Replace <…> with your own values

## When to use it
- retrieve calendar events across a specific date window
- schedule recurring events with custom repeat frequencies
- filter pending VTODO tasks by status or due dates
- update or delete an existing appointment by its UID

## Example prompts
- List my calendars and fetch all scheduled meetings for tomorrow
- Add a recurring sprint planning event every Monday at 10 AM
- Show me incomplete tasks due before Friday

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44874
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22053
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12791
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9602
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2318
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2067

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md