CalDAV MCP

What is caldav-mcp?

caldav-mcp is a CalDAV client that utilizes the Model Context Protocol (MCP) to expose calendar operations as tools for AI assistants. It enables AI assistants to interact with CalDAV servers to manage calendar events.

How to use caldav-mcp?

To use caldav-mcp, you need to set up the MCP server. This involves configuring the mcpServers in your project with the command as npx, args as ["caldav-mcp"], and environment variables for CALDAV_BASE_URL, CALDAV_USERNAME, and CALDAV_PASSWORD. After setup, compile the TypeScript code to JavaScript using npx tsc and then run the MCP server using node index.js.

Key Features of caldav-mcp

• CalDAV Server Connectivity: Connects to various CalDAV servers.
• Event Creation: Allows for the creation of new calendar events.
• Event Listing: Provides functionality to list calendar events within a specified timeframe.
• AI Assistant Integration: Exposes calendar operations as tools for seamless integration with AI assistants.

Use Cases of caldav-mcp

• Automated Calendar Management: AI assistants can automatically create and manage calendar events based on user commands or other triggers.
• Meeting Scheduling: AI assistants can schedule meetings by checking availability and creating events.
• Event Reminders: AI assistants can retrieve event lists and provide timely reminders to users.
• Integration with Productivity Tools: Can be integrated into broader AI-powered productivity suites to enhance calendar functionalities.

FAQ about caldav-mcp

Q: What is MCP? A: MCP stands for Model Context Protocol, which is a protocol designed to expose operations as tools for AI assistants.

Q: What kind of calendar operations can caldav-mcp perform? A: caldav-mcp can create new calendar events and list existing events within a specified timeframe.

Q: What information do I need to connect to a CalDAV server? A: You need the CalDAV server URL, your username, and your password to configure the connection.

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