Log inSubmit server
Caldav MCP logo

Caldav MCP

MCP tools for managing CalDAV calendars, events, and tasks with ISO 8601 dates and recurrence support.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Caldav MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "caldav-mcp": {
      "command": "npx",
      "args": [
        "caldav-mcp"
      ],
      "env": {
        "CALDAV_BASE_URL": "YOUR_VALUE_HERE",
        "CALDAV_USERNAME": "YOUR_VALUE_HERE",
        "CALDAV_PASSWORD": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx caldav-mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 23d ago.

Overview

The caldav-mcp MCP server connects AI assistants to CalDAV servers for calendar and task management. It exposes tools to list calendars, query and modify events, and manage VTODO tasks through a configured CalDAV endpoint. Events support all-day scheduling, recurrence rules, locations, and descriptions, while tasks support status and due-date filtering. Use it when an agent needs to read or update calendars and task lists through MCP.

Use cases

  • List calendars and inspect upcoming events
  • Create recurring or whole-day calendar events
  • Update or delete events by UID
  • Track tasks with status and due-date filters
  • Complete or remove CalDAV tasks

Key features

  • CalDAV calendar discovery
  • Event listing and mutation
  • Whole-day and recurring events
  • VTODO task management
  • Task status and due-date filtering
  • Pagination for task results

Tools22

What Caldav MCP lets your agent do. Expand a tool for its parameters.

Self-reported~310 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

7/7 checks healthy over the last 40d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · caldav-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars103Stargazers on the source repository.
npm downloads1.9kPackage downloads in the last 30 days.
Last commit1d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed22Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Caldav MCP works

What caldav-mcp does

The caldav-mcp MCP server exposes CalDAV calendar operations as tools for an MCP-compatible assistant. It connects to a configured CalDAV server and lets an agent discover calendars, inspect events within a date range, and create, change, or remove events by UID.

It also handles VTODO task records. Agents can list tasks, create new tasks, update existing ones, mark tasks as completed, and delete them. This makes the server suitable for calendar and task workflows in the Workplace & Productivity category.

How it works

The server uses three environment variables to authenticate and locate the CalDAV service: CALDAV_BASE_URL, CALDAV_USERNAME, and CALDAV_PASSWORD. MCP clients start the process, typically through the npx caldav-mcp command, and communicate with the exposed tools.

Calendar operations require the target calendar URL. The list-calendars tool returns calendar names and URLs, which can then be supplied to event or task tools. Event searches use ISO 8601 start and end values. Results include event identifiers and commonly available fields such as summary, start, end, description, and location.

Updates and deletions use a UID returned by a listing operation. Event creation and updates can represent whole-day events and can include recurrence settings such as frequency, interval, count, end date, weekdays, month days, and months.

Task listings default to open tasks, covering NEEDS-ACTION and IN-PROCESS. They can be filtered by exact status or by due-date bounds, and paged with limit and offset. A task may have a due date, a start date, or neither.

Setup and configuration

Add the server to an MCP client configuration with npx as the command and caldav-mcp as its argument. Set the three required environment variables to values for the target CalDAV service:

  • CALDAV_BASE_URL: CalDAV server URL
  • CALDAV_USERNAME: CalDAV account username
  • CALDAV_PASSWORD: CalDAV account password

For local development, the repository documents npm run dev, which runs the TypeScript source with watch mode and loads variables from .env. It also supports compiling with npx tsc and running the resulting dist/index.js file.

Tools and capabilities

The caldav-mcp MCP server provides these tool groups:

  • Calendar discovery with list-calendars
  • Event listing by calendar and time range
  • Event creation, partial updates, and deletion
  • Recurring and whole-day event support
  • Task listing with status, due-date, and pagination filters
  • Task creation, updates, completion, and deletion

Task and event operations return created or updated UIDs, while successful deletions return a confirmation message.

Limitations and notes

The documented inputs use ISO 8601 date or datetime strings. Event and task changes require the relevant calendar URL, and updates or deletions require a UID obtained from a listing tool. Task results default to a maximum of 50 items and support a maximum limit of 500.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Caldav MCP

caldav-mcp is an MCP server that connects AI assistants to CalDAV servers. Its main tools list calendars, query and manage events, and create, update, complete, or delete VTODO tasks. It supports ISO 8601 dates, whole-day events, recurrence rules, task statuses, due-date filters, and paginated task results.

Install it by configuring an MCP client to run `npx caldav-mcp`. Provide `CALDAV_BASE_URL`, `CALDAV_USERNAME`, and `CALDAV_PASSWORD` in the server environment. For repository development, use `npm run dev`, or compile with `npx tsc` and run `node dist/index.js`.

caldav-mcp requires `CALDAV_BASE_URL`, `CALDAV_USERNAME`, and `CALDAV_PASSWORD`. These values identify the CalDAV server and provide the username and password used by the server process.

Use `list-events` to obtain the event UID, then pass that UID and the calendar URL to `update-event` or `delete-event`. Updates change only the fields supplied, and deletion returns a confirmation when successful.

Yes, caldav-mcp manages CalDAV VTODO tasks through `list-todos`, `create-todo`, `update-todo`, `complete-todo`, and `delete-todo`. Listings support status filters, due-date bounds, and pagination, while tasks may be created without dates.

Related MCP servers

All in Workplace & Productivity All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewCaldav MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/caldav-mcp?style=directory)](https://allmcps.com/mcp/caldav-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/caldav-mcp"><img src="https://allmcps.com/api/badge/caldav-mcp?style=directory" alt="Caldav MCP on AllMCPs" /></a>