mcp-ical MCPサーバー

「mcp-ical」MCPサーバーは何をする？

mcp-ical MCPサーバーは、AIアシスタントとmacOSカレンダーをつなぐ架け橋となり、カレンダー管理のための自然言語でのシームレスなやり取りを可能にします。Model Context Protocol（MCP）を活用し、ユーザーは会話形式でスケジュールの確認、イベント作成、予定の更新、カレンダーの管理などを実現できます。これにより、従来手動だったカレンダー操作が直感的なAIワークフローへと進化し、生産性が大きく向上します。スマートリマインダー、繰り返しイベント、カスタムカレンダーのサポート（iCloud経由のGoogleカレンダー連携も含む）などの機能により、スケジューリングや空き状況の確認、イベント更新が効率化され、カレンダー管理をAI開発や個人のワークフローに直接統合したい開発者やユーザーにとって貴重なツールとなります。

プロンプト一覧

リポジトリのドキュメントやコードに明示的なプロンプトテンプレートは記載されていません。

リソース一覧

ドキュメントや利用可能なファイルに明確なMCPリソースの説明はありません。

ツール一覧

• イベント作成：自然言語入力から即座にカレンダーイベントを作成
• スマートスケジュールクエリ：ユーザーの問い合わせに応じて今後のイベント取得や空き状況確認
• イベント更新：既存のイベントの時間・日付・カレンダー・場所・メモ・リマインダー・繰り返しなどを編集
• カレンダー一覧：利用可能なカレンダーを表示し、スマートな提案も受け取れます

このMCPサーバーのユースケース

• 自然言語によるカレンダー管理： 「来週の予定は？」のようにAIアシスタントに尋ねるだけで整理された予定一覧を取得。カレンダーアプリを手動で確認する手間が省けます。
• イベント作成の自動化： 開発者はチャット入力に基づき会議・リマインダー・締切などのイベントを自動スケジューリングできます。
• インテリジェントな空き状況確認： 会議やアポイントメントの空き時間をすばやく見つけ、生産性向上と調整の手間削減に役立ちます。
• イベントの編集： 自然言語リクエストで既存イベントのリスケや場所変更、メモ追加などを簡単に実行できます。
• 複数カレンダー・Googleカレンダー対応： 複数カレンダーやiCloud同期済みのGoogleカレンダーもまとめて会話から操作可能です。

セットアップ方法

Windsurf

1. 前提条件：Node.jsとPython 3.12+がインストールされていることを確認してください。
2. Windsurfの設定ファイル（例：windsurf.config.json）を見つけます。
3. mcpServersセクションにmcp-ical MCPサーバーを追加します:

   {
     "mcpServers": {
       "ical-mcp": {
         "command": "npx",
         "args": ["@mcp-ical/mcp-server@latest"]
       }
     }
   }
   

4. 設定を保存し、Windsurfを再起動します。
5. MCP連携にサーバーが表示されていることを確認します。

APIキーの保護例：

{
  "mcpServers": {
    "ical-mcp": {
      "command": "npx",
      "args": ["@mcp-ical/mcp-server@latest"],
      "env": {
        "ICAL_API_KEY": "${ICAL_API_KEY}"
      },
      "inputs": {
        "ICAL_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude

1. 前提条件：Python 3.12+。
2. Claudeの連携設定ファイルを開きます。
3. mcp-ical用に以下のJSONを挿入します:

   {
     "mcpServers": {
       "ical-mcp": {
         "command": "npx",
         "args": ["@mcp-ical/mcp-server@latest"]
       }
     }
   }
   

4. 保存してClaudeを再起動します。
5. カレンダー接続を確認します。

Cursor

1. 前提条件：Node.jsとPython 3.12+がインストールされていること。
2. Cursorの設定ファイルを見つけます。
3. mcp-icalサーバーを追加します:

   {
     "mcpServers": {
       "ical-mcp": {
         "command": "npx",
         "args": ["@mcp-ical/mcp-server@latest"]
       }
     }
   }
   

4. 保存してCursorを再起動します。
5. MCPモードでサーバーが稼働しているか確認します。

Cline

1. 前提条件：Node.jsとPython 3.12+をインストールします。
2. Clineの設定ファイルを編集します。
3. mcp-icalサーバーを追加します:

   {
     "mcpServers": {
       "ical-mcp": {
         "command": "npx",
         "args": ["@mcp-ical/mcp-server@latest"]
       }
     }
   }
   

4. ファイルを保存し、Clineを再起動します。
5. カレンダーコマンドで動作をテストします。

注: ICAL_API_KEYなどの機密情報は環境変数に置き換えてセキュリティを確保してください。

Flow内でのMCP利用方法

FlowHuntでのMCP活用

FlowHuntワークフローにMCPサーバーを組み込むには、まずフローにMCPコンポーネントを追加し、AIエージェントと接続します。

MCPコンポーネントをクリックして設定パネルを開き、system MCP設定セクションで下記JSON形式にてMCPサーバー情報を入力します：

{
  "ical-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

設定後、AIエージェントはこのMCPサーバーの全機能・ツールを利用できるようになります。“ical-mcp"は実際のMCPサーバー名に、URLはご自身のサーバーURLに置き換えてください。

概要

Roots対応: ⛔ 未記載
サンプリング対応: ⛔ 未記載

表から分かる通り、MCP-icalサーバーは機能やセットアップに関して十分なドキュメントがありますが、明示的なリソースやプロンプトテンプレートはありません。Rootsやサンプリングのサポートについても記載はありません。ユーティリティとドキュメント充実度は6/10と評価します。

MCPスコア