Google Calendar MCP Server

Google Calendar MCP サーバー

この MCP サーバーは Google Calendar と連携し、標準化されたインターフェースを通じて Claude がカレンダーの予定を表示、作成、管理できるようにします。

機能

• 利用可能なカレンダーの一覧表示
• カレンダーの予定の一覧表示
• 新しいカレンダーの予定の作成
• 既存の予定の更新
• 予定の削除

前提条件

• Node.js 16 以降
• Calendar API が有効になっている Google Cloud プロジェクト
• OAuth 2.0 認証情報（クライアント ID とクライアントシークレット）

Google Cloud のセットアップ

1. Google Cloud Console にアクセスします
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します
3. Google Calendar API を有効にします
4. OAuth 2.0 認証情報を作成します：
   • Credentials に移動します
   • "Create Credentials" > "OAuth client ID" をクリックします
   • アプリケーションの種類として "Desktop app" を選択します
   • 名前を付けます（例："Google Calendar MCP"）
   • 認証情報の JSON ファイルをダウンロードします
   • ダウンロードしたファイルの名前を gcp-oauth.keys.json に変更し、このプロジェクトのルートディレクトリに配置します

インストール

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

   npm install
   

2. TypeScript コードをビルドします：

   npm run build
   

3. このサーバーを含めるように Claude MCP 設定ファイルを更新します：

   • cline_mcp_settings.json に以下を追加します：

   "github.com/pashpashpash/google-calendar-mcp": {
     "command": "node",
     "args": ["C:/Users/ralph/Documents/Cline/MCP/google-calendar-mcp/build/index.js"],
     "env": {},
     "disabled": false,
     "autoApprove": []
   }
   

認証プロセス

Google Calendar MCP サーバーを初めて使用すると、次の処理が行われます：

1. 認証トークンがないことを検出します
2. 認証サーバーを起動します（ポート 3000～3004）
3. OAuth 認証用のブラウザーウィンドウを開きます
4. 認証トークンを安全に保存します
5. 認証サーバーを終了し、通常の動作を続行します

認証トークンは .gcp-saved-tokens.json に保存され、自動的に更新されます。

利用可能なツール

ツール	説明
list-calendars	利用可能なすべてのカレンダーを一覧表示します
list-events	特定のカレンダーの予定を一覧表示します
create-event	新しいカレンダーの予定を作成します
update-event	既存のカレンダーの予定を更新します
delete-event	カレンダーの予定を削除します

使用例

カレンダーの一覧表示

list-calendars

予定の一覧表示

list-events
calendarId: "primary"
timeMin: "2023-01-01T00:00:00Z"
timeMax: "2023-12-31T23:59:59Z"
maxResults: 10

予定の作成

create-event
calendarId: "primary"
summary: "Team Meeting"
location: "Conference Room B"
description: "Weekly team sync meeting"
startDateTime: "2023-06-15T10:00:00"
endDateTime: "2023-06-15T11:00:00"
timeZone: "America/New_York"
attendees: ["[email protected]", "[email protected]"]

予定の更新

update-event
calendarId: "primary"
eventId: "event_id_from_list_events"
summary: "Updated Meeting Title"
startDateTime: "2023-06-15T11:00:00"
endDateTime: "2023-06-15T12:00:00"

予定の削除

delete-event
calendarId: "primary"
eventId: "event_id_from_list_events"

トラブルシューティング

• OAuth トークンが 7 日後に期限切れになる：アプリがテストモードの場合は、再認証が必要です。
• 認証エラー：gcp-oauth.keys.json の形式が正しく、プロジェクトのルートに配置されていることを確認してください。
• ポートの競合：認証サーバーはポート 3000～3004 を試します。少なくとも 1 つのポートが使用可能であることを確認してください。