Caldav Mcp

Caldav Mcp

What is Caldav Mcp about?

Caldav Mcp exposes CalDAV calendar functionalities as MCP tools, allowing AI assistants to interact with calendars—creating events and retrieving event lists—through standardized tool calls.

How to use Caldav Mcp?

1. Configure the server in your MCP configuration file by adding a calendar entry with the required environment variables (CALDAV_BASE_URL, CALDAV_USERNAME, CALDAV_PASSWORD).
2. Compile the TypeScript source:

   npx tsc
   

3. Start the MCP server:

   node index.js
   

4. Invoke the provided tools (create-event, list-events) from an AI assistant or any MCP‑compatible client.

Key Features

• Connects to any CalDAV server using supplied credentials.
• create-event tool: creates a new calendar event and returns its unique ID.
• list-events tool: returns summaries of events occurring within a specified timeframe.
• Simple JSON‑based MCP configuration with npx execution.

Use Cases

• Enable AI chatbots to schedule meetings on a user's calendar.
• Automate daily agenda generation by listing upcoming events.
• Integrate calendar actions into larger workflow automation pipelines.
• Provide voice assistants with the ability to manage personal or team calendars.

FAQ

Q: Which CalDAV servers are supported? A: Any server that adheres to the CalDAV standard; just provide the base URL and valid credentials.

Q: Do I need to build the project before running it? A: Yes, run npx tsc to compile TypeScript to JavaScript.

Q: How are credentials supplied securely? A: Through environment variables (CALDAV_USERNAME, CALDAV_PASSWORD) in the MCP configuration.

Q: Can I run multiple calendar instances? A: Add additional entries under mcpServers with distinct names and configuration values.

Q: What output does list-events return? A: An array of event summary strings that fall within the requested time range.

caldav-mcp

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

✨ 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 server URL>",
        "CALDAV_USERNAME": "<CalDAV username>",
        "CALDAV_PASSWORD": "<CalDAV password>"
      }
    }
  }
}

Usage

1. Compile TypeScript to JavaScript:

npx tsc

2. 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

License

MIT