CM

CalDAV MCP

Created 5 months ago

A CalDAV Model Context Protocol (MCP) server to expose calendar operations as tools for AI assistants.

development documentation public

What is CalDAV MCP?

A CalDAV MCP server to expose calendar operations as tools for AI assistants.

Documentation

Features

  • Connect to CalDAV servers
  • Create calendar events
  • List calendar events within a specific timeframe

Setup

{
  "mcpServers": {
    ..., 
    "calendar": {
      "command": "npx",
      "args": [ "caldav-mcp" ],
      "env": {
        "CALDAV_BASE_URL": "",
        "CALDAV_USERNAME": "",
        "CALDAV_PASSWORD": ""
      }
    }
  }
}

Usage

  1. Compile TypeScript to JavaScript:
npx tsc
  1. Run the MCP server:
node index.js

Available Tools# create-event

Creates a new calendar event. Parameters:

  • summary: String - Event title/summary
  • start: DateTime string - Event start time
  • end: DateTime string - Event end time Returns:
  • The unique ID of the created event

list-events

Lists events within a specified timeframe. Parameters:

  • start: DateTime string - Start of the timeframe
  • end: DateTime string - End of the timeframe Returns:
  • A list of event summaries that fall within the given timeframe

Server Config

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

Links & Status

Repository: github.com
Hosted: No
Global: No
Official: No

Project Info

Hosted Featured
Created At: Jul 02, 2025
Updated At: Aug 07, 2025
Author: dominick1001
Category: community
License: MIT
Tags:
development documentation public