Outlook Calendar MCP Tool

Outlook Calendar MCP ツール

Claude がローカルの Microsoft Outlook カレンダーにアクセスして管理できるようにする Model Context Protocol（MCP）サーバーです（Windows のみ）。

機能

• カレンダーの予定を表示：日付範囲内の予定を一覧表示し、予定の詳細を表示して、出席者のステータスを確認します
• カレンダーの予定を管理：予定や会議を新規作成し、既存の予定を更新します
• カレンダーインテリジェンス：スケジュール調整のための空き時間を検索し、最適な会議時間を特定します
• 複数のカレンダーに対応：Outlook プロファイル内のさまざまなカレンダーにアクセスします

前提条件

• Windows オペレーティングシステム
• Microsoft Outlook デスクトップクライアントがインストールされていること
• VBScript のサポート（Windows 11 24H2 以降をお使いの場合は、以下の「VBScript のインストール」を参照してください）
• Node.js（バージョン 14.x 以降）
• npm（Node.js に付属）

VBScript のインストール（Windows 11 24H2 以降をお使いの場合）

重要：Windows 11 24H2 以降では、VBScript は既定でインストールされなくなり、オプション機能として有効にする必要があります。

Windows の更新後に MCP サーバーが動作しない場合は、VBScript のインストールが必要な可能性があります。

1. 設定（Windows + I）を開きます
2. アプリ → オプション機能に移動します
3. **「オプション機能を追加する」の横にある「機能を表示」**をクリックします
4. **「VBScript」**を検索します
5. VBScriptを選択し、インストールをクリックします
6. インストール後、コンピューターを再起動します

VBScript の非推奨化の予定：

• フェーズ 1（2024 年後半以降）：Windows 11 24H2 でオプション機能として利用可能
• フェーズ 2（2027 年頃）：既定で有効ではなくなります
• フェーズ 3（将来）：Windows から完全に削除されます

注：VBScript の非推奨化に関するコミュニティからのフィードバックを受け、プロジェクトの将来性を高めるためのアーキテクチャ改善を検討しています。

インストール

オプション 1：npm からインストール

npm install -g outlook-calendar-mcp

インストールせずに npx で直接実行することもできます。

npx outlook-calendar-mcp

オプション 2：ソースからインストール

1. このリポジトリをクローンするか、ソースコードをダウンロードします
2. 依存関係をインストールします。

npm install

3. サーバーを実行します。

npm start

MCP サーバーの設定

このツールを Claude で使用するには、MCP 設定ファイルに追加する必要があります。

Claude デスクトップアプリの場合

Claude のデスクトップ設定ファイル（%APPDATA%\Claude\claude_desktop_config.json にあります）に以下を追加します。

npm でグローバルインストールした場合：

{
  "mcpServers": {
    "outlook-calendar": {
      "command": "outlook-calendar-mcp",
      "args": [],
      "env": {}
    }
  }
}

npx を使用する場合（インストールなし）：

{
  "mcpServers": {
    "outlook-calendar": {
      "command": "npx",
      "args": ["-y", "outlook-calendar-mcp"],
      "env": {}
    }
  }
}

ソースからインストールした場合：

{
  "mcpServers": {
    "outlook-calendar": {
      "command": "node",
      "args": ["path/to/outlook-calendar-mcp/src/index.js"],
      "env": {}
    }
  }
}

Claude VSCode 拡張機能の場合

Claude VSCode 拡張機能の MCP 設定ファイル（%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json にあります）に以下を追加します。

npm でグローバルインストールした場合：

{
  "mcpServers": {
    "outlook-calendar": {
      "command": "outlook-calendar-mcp",
      "args": [],
      "env": {}
    }
  }
}

npx を使用する場合（インストールなし）：

{
  "mcpServers": {
    "outlook-calendar": {
      "command": "npx",
      "args": ["-y", "outlook-calendar-mcp"],
      "env": {}
    }
  }
}

ソースからインストールした場合：

{
  "mcpServers": {
    "outlook-calendar": {
      "command": "node",
      "args": ["path/to/outlook-calendar-mcp/src/index.js"],
      "env": {}
    }
  }
}

ソースからインストールした場合は、path/to/outlook-calendar-mcp を、このツールをインストールした実際のパスに置き換えてください。

使用方法

設定が完了すると、Claude は以下のツールを利用できます。

カレンダーの予定を一覧表示

list_events
- startDate: Start date in MM/DD/YYYY format
- endDate: End date in MM/DD/YYYY format (optional)
- calendar: Calendar name (optional)

例：「来週のカレンダーの予定を一覧表示して」

カレンダーの予定を作成

create_event
- subject: Event subject/title
- startDate: Start date in MM/DD/YYYY format
- startTime: Start time in HH:MM AM/PM format
- endDate: End date in MM/DD/YYYY format (optional)
- endTime: End time in HH:MM AM/PM format (optional)
- location: Event location (optional)
- body: Event description (optional)
- isMeeting: Whether this is a meeting with attendees (optional)
- attendees: Semicolon-separated list of attendee email addresses (optional)
- calendar: Calendar name (optional)

例：「金曜日の午後 2 時に、プロジェクト提案について John との会議を追加して」

空き時間を検索

find_free_slots
- startDate: Start date in MM/DD/YYYY format
- endDate: End date in MM/DD/YYYY format (optional)
- duration: Duration in minutes (optional)
- workDayStart: Work day start hour (0-23) (optional)
- workDayEnd: Work day end hour (0-23) (optional)
- calendar: Calendar name (optional)

例：「今週、1 時間の会議を入れられる時間はいつ？」

出席者のステータスを取得

get_attendee_status
- eventId: Event ID
- calendar: Calendar name (optional)

例：「チーム会議の招待にまだ返信していないのは誰？」

重要な注意：イベント ID が必要な操作（update_event、delete_event、get_attendee_status）を使用する場合は、list_events の応答にある id フィールドを使用してください。これは Outlook が予定を識別するために使用する一意の EntryID です。

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

update_event
- eventId: Event ID to update
- subject: New event subject/title (optional)
- startDate: New start date in MM/DD/YYYY format (optional)
- startTime: New start time in HH:MM AM/PM format (optional)
- endDate: New end date in MM/DD/YYYY format (optional)
- endTime: New end time in HH:MM AM/PM format (optional)
- location: New event location (optional)
- body: New event description (optional)
- calendar: Calendar name (optional)

例：「明日のチームミーティングを、午後2時ではなく午後3時に開始するよう更新してください」

カレンダーを取得

get_calendars

例：「利用可能なカレンダーを表示してください」

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

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

トラブルシューティング

• VBScript を利用できない場合（Windows 11 24H2 以降）：Windows の更新後にエラーが発生する場合は、VBScript のインストールが必要な可能性があります。上記の「VBScript のインストール」セクションを参照してください
• 「スクリプトの実行に失敗しました」というエラー：通常、VBScript を利用できないか、Outlook にアクセスできないことを示します
• Outlook のセキュリティプロンプト：Outlook のセキュリティプロンプトが表示された場合は、スクリプトによる Outlook データへのアクセスを許可する必要があります
• スクリプトの実行ポリシー：スクリプトの実行エラーが発生した場合は、PowerShell の実行ポリシーを調整する必要がある可能性があります
• パスの問題：MCP 設定ファイル内のパスが、ツールの正しい場所を指していることを確認してください

コントリビューション

Outlook Calendar MCP Tool へのコントリビューションを歓迎します。始める方法について詳しくは、コントリビューションガイドをご覧ください。

このプロジェクトに参加することで、行動規範を遵守することに同意したものとみなされます。

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細はLICENSEファイルをご覧ください。