Dav MCP server

dav-mcp

Give your AI agents the power of organization — Transform them into orchestrating assistants managing calendars, contacts, and tasks.

Built on 26 production-ready tools spanning CalDAV, CardDAV, and VTODO protocols.

Quick Start

Claude Desktop / Cursor (Local)

Add to your MCP config file:

{
  "mcpServers": {
    "dav-mcp": {
      "command": "npx",
      "args": ["-y", "dav-mcp"],
      "env": {
        "CALDAV_SERVER_URL": "https://dav.example.com",
        "CALDAV_USERNAME": "your_username",
        "CALDAV_PASSWORD": "your_password"
      }
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
• Windows: %APPDATA%\Claude\claudedesktopconfig.json
• Linux: ~/.config/Claude/claudedesktopconfig.json

Restart Claude Desktop after adding the configuration.

n8n (Remote HTTP)

Start the HTTP server:

CALDAV_SERVER_URL=https://dav.example.com \
CALDAV_USERNAME=your_username \
CALDAV_PASSWORD=your_password \
BEARER_TOKEN=your-secret-token \
npx dav-mcp --http

Then in n8n:

1. Add AI Agent node
2. Add MCP Client Tool node and connect to AI Agent
3. Configure:

• MCP Endpoint: http://localhost:3000/mcp
• Authentication: Bearer
• Token: your-secret-token

Custom port:

npx dav-mcp --http --port=8080

Docker

Pull the published image (distroless, runs as non-root, no shell):

docker run -d --name dav-mcp -p 3000:3000 --env-file .env \
  ghcr.io/philflowio/dav-mcp:latest

Tags: latest, the exact release (4.0.0) and the minor line (4.0). Set PORT to serve on a different port; the healthcheck follows it.

Or build from source:

git clone https://github.com/PhilflowIO/dav-mcp.git
cd dav-mcp
cp .env.example .env
# Edit .env with your credentials
docker-compose up

The Orchestration

When partial tools force your AI to improvise, complete tools let it execute precise operations across all components.

Available Tools (27 Total)

CalDAV Tools (12 tools)

1. listcalendars** - List all available calendars
2. listevents - List ALL events (use calendarquery for filtered searches)
3. createevent** - Create a new calendar event
4. updateevent - PREFERRED: Update any event field (SUMMARY, LOCATION, STATUS, custom X- properties); move or convert an event with startdate/enddate/all_day
5. updateeventraw - Update event with raw iCal data (advanced)
6. deleteevent** - Delete an event permanently
7. calendarquery** - PREFERRED: Search and filter events efficiently by text, date range, or location
8. makecalendar** - Create a new calendar collection
9. updatecalendar** - Update calendar properties (display name, description, color, timezone)
10. deletecalendar** - Permanently delete a calendar and all its events
11. calendarmultiget - Batch fetch multiple specific events by URLs
12. freebusyquery** - Find free and busy time in a range ("when am I free?"), calculated client-side

Shortened. The full README is on GitHub.