🗓️ カレンダー操作をAIアシスタント向けのツールとして公開するためのCalDAVモデルコンテキストプロトコル(MCP)サーバー。

✨ 特徴

• CalDAVサーバーに接続
• リストカレンダー
• 特定の期間内のカレンダーイベントを一覧表示
• カレンダーイベントの作成
• カレンダーイベントの更新
• UIDによるカレンダーイベントの削除

セットアップ

開発

クイックスタート

自動リロードで開発モードでMCPサーバーを起動します:

これにより、ウォッチモードでTypeScriptのコードを直接実行し、.envから環境変数を自動的に読み込みます。

手動ビルド

あるいは、TypeScriptをJavaScriptにコンパイルして実行することもできます:

1. コンパイル:

2. 走る:

利用可能なツール

リストカレンダー

名前と絶対URLの両方を返すすべてのカレンダーをリストアップします。カレンダーのurlを変更せずにcalendarUrlとして他のツールに渡します。

パラメータ:なし

返品:

• 利用可能なすべてのカレンダー一覧

イベント一覧

URLで指定されたカレンダーに、開始日から終了日までのすべてのイベントを一覧にしてください

パラメータ:

• calendarUrl:文字列
• end:文字列 — 終了日(ISO 8601)
• start:文字列 — 開始日(ISO 8601)

返品:

caldav-mcp

✨ Features

• Connect to CalDAV servers
• List calendars
• List calendar events within a specific timeframe
• Create calendar events
• Update calendar events
• Delete calendar events by UID

Setup

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

Development

Quick Start

Run the MCP server in development mode with auto-reload:

npm run dev

This will run the TypeScript code directly with watch mode and automatically load environment variables from .env.

Manual Build

Alternatively, you can compile TypeScript to JavaScript and run it:

1. Compile:

npx tsc

2. Run:

node dist/index.js

Available Tools

list-calendars

List all calendars returning both name and absolute URL. Pass a calendar’s url unchanged as calendarUrl to the other tools.

Parameters: none

Returns:

• List of all available calendars

list-events

List all events between start and end date in the calendar specified by its URL

Parameters:

• calendarUrl: string
• end: string — End date (ISO 8601)
• start: string — Start date (ISO 8601)

Returns:

• A list of events that fall within the given timeframe, each containing uid, summary, start, end, and optionally description and location

create-event

Creates an event in the calendar specified by its URL. For all-day events, set wholeDay to true. For a single-day all-day event, use start and end datetimes on the same calendar date; they do not need to be identical timestamps.

Parameters:

• calendarUrl: string
• description: string (optional)
• end: string — End datetime (ISO 8601)
• location: string (optional)
• recurrenceRule: object (optional)