CalDAV

v1.0.0Communicationstable

An MCP server that exposes CalDAV calendar operations as tools for AI assistants. It enables users to connect to CalDAV servers to create and list calendar events within specific timeframes.

caldavmcpmcp-servertypescript
Share:
71
Stars
0
Downloads
0
Weekly
0/5

What is CalDAV?

CalDAV is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server that exposes caldav calendar operations as tools for ai assistants. it enables users to connect to caldav servers to create and list calendar events within specific timeframes.

An MCP server that exposes CalDAV calendar operations as tools for AI assistants. It enables users to connect to CalDAV servers to create and list calendar events within specific timeframes.

This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • An MCP server that exposes CalDAV calendar operations as too

Use Cases

Create and list calendar events in CalDAV servers.
Manage calendar operations across specific timeframes.
dominik1001

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y caldav

Manual Installation

npx -y caldav

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use CalDAV

The CalDAV MCP server exposes CalDAV calendar operations as tools for AI assistants, enabling them to list calendars, create and update events, list events within date ranges, and delete events on any CalDAV-compatible server. It works with self-hosted solutions like Nextcloud, Baikal, and Radicale, as well as hosted services that expose a CalDAV endpoint, giving users natural-language control over their calendar from any MCP client.

Prerequisites

  • Node.js 18 or later installed
  • A CalDAV server URL (e.g. Nextcloud, iCloud, Baikal, Radicale, or any CalDAV provider)
  • CalDAV username and password credentials
  • An MCP-compatible client such as Claude Desktop or Claude Code
1

Locate your CalDAV server URL

Find the CalDAV base URL for your calendar provider. For Nextcloud it is typically https://your-nextcloud.example.com/remote.php/dav. For iCloud it is https://caldav.icloud.com. Your hosting provider's documentation will have the exact URL.

2

Configure your MCP client

Add the caldav-mcp server to your MCP client configuration with the three required environment variables: CALDAV_BASE_URL, CALDAV_USERNAME, and CALDAV_PASSWORD.

{
  "mcpServers": {
    "caldav": {
      "command": "npx",
      "args": ["-y", "caldav"],
      "env": {
        "CALDAV_BASE_URL": "https://your-caldav-server.example.com",
        "CALDAV_USERNAME": "your_username",
        "CALDAV_PASSWORD": "your_password"
      }
    }
  }
}
3

Restart your MCP client

Restart Claude Desktop or reload your MCP client to load the CalDAV server with your credentials.

4

List your calendars

Ask your AI assistant to list your calendars. The list-calendars tool returns all available calendars with their names and URLs, which you can reference for subsequent event operations.

5

Create or retrieve events

Use natural language to create events with summaries, date/time, location, description, and recurrence rules, or list events within a specific date range using ISO 8601 format dates.

CalDAV Examples

Client configuration

Complete claude_desktop_config.json entry for the CalDAV MCP server with required environment variables.

{
  "mcpServers": {
    "caldav": {
      "command": "npx",
      "args": ["-y", "caldav"],
      "env": {
        "CALDAV_BASE_URL": "https://your-caldav-server.example.com",
        "CALDAV_USERNAME": "your_username",
        "CALDAV_PASSWORD": "your_password"
      }
    }
  }
}

Prompts to try

Example prompts to use once the CalDAV MCP server is connected to your AI assistant.

- "List all my calendars"
- "Show me all events from June 1 to June 30, 2026"
- "Create a team meeting event on June 20 at 2 PM titled 'Sprint Review'"
- "Add a recurring weekly standup every Monday at 9 AM"
- "Delete the event with UID abc123 from my work calendar"

Troubleshooting CalDAV

Authentication failed connecting to CalDAV server

Double-check CALDAV_USERNAME and CALDAV_PASSWORD. Some providers (like iCloud) require an app-specific password rather than your main account password. Generate an app-specific password in your account security settings.

No calendars returned from list-calendars

Verify the CALDAV_BASE_URL is the correct CalDAV principal or home-set URL, not just the general server URL. For Nextcloud, ensure the URL includes /remote.php/dav/principals/users/your_username/ or the correct dav path.

Event creation succeeds but events do not appear in calendar app

CalDAV clients may cache calendar data. Force a sync in your calendar app. Also ensure the calendar URL used in create-event matches a URL returned by list-calendars for your writable calendar.

Frequently Asked Questions about CalDAV

What is CalDAV?

CalDAV is a Model Context Protocol (MCP) server that mcp server that exposes caldav calendar operations as tools for ai assistants. it enables users to connect to caldav servers to create and list calendar events within specific timeframes. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install CalDAV?

Install via npm with the command: npx -y caldav. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with CalDAV?

CalDAV works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is CalDAV free to use?

Yes, CalDAV is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Communication MCP Servers

Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "caldav": { "command": "npx", "args": ["-y", "caldav"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use CalDAV?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides