dav-mcp

Name: dav-mcp
Author: PhilflowIO

@PhilflowIO

Repository

About dav-mcp

Transform AI agents into orchestrating assistants managing calendars, contacts, and tasks

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "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"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is dav-mcp?

dav-mcp is an MCP server that gives AI agents 26 tools to manage calendars, contacts, and tasks via CalDAV, CardDAV, and VTODO protocols. It is built for developers and automation users who want their AI assistants to orchestrate real organizational data from any RFC‑compliant server.

How to use dav-mcp?

Configure dav-mcp by setting environment variables (CALDAV_SERVER_URL, CALDAV_USERNAME, CALDAV_PASSWORD) and running it with npx. For local use with Claude Desktop or Cursor, add the command to the MCP config file; for remote use with n8n, start the HTTP server with a bearer token. A Docker setup is also available via docker-compose up.

Key features of dav-mcp

26 tools: full CRUD for calendars, contacts, and tasks
Field‑based updates on all RFC properties plus custom fields
Server‑side filtering for efficient queries (calendar_query, addressbook_query, todo_query)
Multi‑provider: works with any CalDAV/CardDAV server
OAuth2 authentication for Google Calendar
Input validation, rate limiting, bearer auth, and no credential storage

Use cases of dav-mcp

“Show me all Friday meetings” → calendar_query with date filter returns only relevant events
“Find everyone at Google” → addressbook_query with org filter finds matches efficiently
“Show overdue high‑priority tasks” → todo_query with filters returns specific results
“Create a new calendar called Project Luna” → make_calendar creates the collection
Daily cron job to delete completed tasks using targeted queries

FAQ from dav-mcp

What protocols does dav-mcp support?

It supports CalDAV (RFC 4791), CardDAV (RFC 6352), and VTODO for tasks.

Which calendar/contact providers are compatible?

Any server following the CalDAV/CardDAV RFCs, including Nextcloud, Baikal, Radicale, and iCloud (with app‑specific password). Google Calendar is supported via OAuth2.

How do I authenticate?

Use basic authentication (username/password) for standard servers, or OAuth2 for Google Calendar by providing client ID, client secret, and refresh token.

What security measures are in place?

Inputs are validated with Zod schemas, rate‑limiting at 100 requests/minute in HTTP mode, bearer token authentication, no credential storage, structured audit logs without PII, and CORS protection.