Outlook Calendar MCP

🚀 OutlookカレンダーMCPツール

このツールはModel Context Protocol（MCP）サーバーで、ClaudeがローカルのMicrosoft Outlookカレンダーにアクセスし管理できるようにします。Windowsシステムのみで使用可能です。

🚀 クイックスタート

このツールは、ClaudeがWindowsシステム上のMicrosoft Outlookカレンダーを操作できるようにするためのものです。以下の手順に従ってインストールと設定を行い、カレンダー操作を開始しましょう。

✨ 主な機能

• カレンダーイベントの表示：すべてのカレンダーイベントを表示します。
• カレンダーイベントの作成：新しいカレンダーイベントを追加します。
• カレンダーイベントの更新：既存のカレンダーイベントを修正します。
• カレンダーイベントの削除：不要なカレンダーイベントを削除します。
• 参加者の状態の取得：参加者の応答状態を確認します。
• 空き時間の検索：利用可能な時間帯を検索します。
• カレンダーリストの取得：利用可能なすべてのカレンダーを表示します。

📦 インストール

方法一：npmを使用したインストール

npm install outlook-calendar-mcp-tool --save-dev

方法二：ソースコードからのインストール

1. リポジトリをクローンします：

   git clone https://github.com/your-username/outlook-calendar-mcp-tool.git
   cd outlook-calendar-mcp-tool
   

2. 依存関係をインストールします：

   npm install
   

📚 ドキュメント

MCPサーバーの設定

Claude Desktop App用：

{
  "operations": {
    "outlookCalendar": {
      "enabled": true,
      "configurations": {
        "pathToOutlook": "C:\\Program Files\\Microsoft Office\\Office16\\OUTLOOK.EXE",
        "defaultCalendar": "Personal Calendar"
      }
    }
  }
}

Claude VSCode拡張機能用：

{
  "outlookCalendarMcpTool": {
    "outlookPath": "C:\\Program Files\\Microsoft Office\\Office16\\OUTLOOK.EXE",
    "defaultCalendarName": "Personal Calendar"
  }
}

💻 使用例

基本的な使用法

カレンダーイベントの表示

list_events [--calendar <カレンダー名>] [--start <開始日>] [--end <終了日>]

カレンダーイベントの作成

create_event --title <タイトル> --start <開始時間> --end <終了時間> [--location <場所>] [--description <説明>] [--calendar <カレンダー名>]

カレンダーイベントの更新

update_event --id <イベントID> [--title <新しいタイトル>] [--start <新しい開始時間>] [--end <新しい終了時間>] [--location <新しい場所>] [--description <新しい説明>] [--calendar <対象カレンダー>]

カレンダーイベントの削除

delete_event --id <イベントID>

参加者の状態の取得

get_attendee_status --event-id <イベントID>

空き時間の検索

find_available_time [--duration <持続時間>] [--start <開始時間>] [--end <終了時間>]

カレンダーリストの取得

get_calendars

🔧 技術詳細

セキュリティに関する注意事項

• 初回使用時に、Outlookがセキュリティ警告を表示する場合があります。スクリプトがOutlookデータにアクセスすることを許可してください。
• このツールはローカルのOutlookクライアントのみにアクセスし、カレンダーデータを外部サーバーに送信することはありません。
• すべてのカレンダー操作はあなたのコンピュータ上でローカルに行われます。

トラブルシューティング

• Outlookセキュリティ警告：セキュリティ警告が表示された場合は、指示に従ってスクリプトがOutlookデータにアクセスすることを許可してください。
• スクリプト実行ポリシーの問題：スクリプト実行エラーが発生した場合は、PowerShellの実行ポリシーを確認して調整してください。
• パスの問題：設定ファイルのパスが正しいツールの場所を指していることを確認してください。

🤝 プロジェクトへの貢献

OutlookカレンダーMCPツールへの貢献を歓迎します！貢献ガイドを参照して、貢献の始め方を確認してください。

📄 ライセンス

このプロジェクトはMITライセンスに準拠しています。詳細な条項はLICENSEファイルを参照してください。