カレンダーMCPサーバー

Claude Desktop に Google カレンダーを統合するためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーにより、AI アシスタントは自然言語によるインタラクションを通じて Google カレンダーのイベントを管理できるようになります。

特徴

タイトル、時間、説明、場所を指定してカレンダーイベントを作成する
イベントIDでイベントの詳細を取得する
既存のイベントを更新する（タイトル、時間、説明、場所）
イベントを削除する
指定した時間範囲内のイベントを一覧表示する
Google カレンダー API との完全な統合
安全なOAuth2認証

Related MCP server: Google Calendar MCP Server

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop に Google カレンダー統合を自動的にインストールするには:

npx -y @smithery/cli install @gongrzhe/server-calendar-mcp --client claude

手動インストール

npm install @gongrzhe/server-calendar-mcp

設定

Google Cloud プロジェクトを作成し、認証情報を取得します。
a. Google Cloud プロジェクトを作成します。
- Google Cloud Consoleに移動
- 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください
- プロジェクトで Google カレンダー API を有効にする
b. OAuth 2.0 認証情報を作成する:
- 「APIとサービス」>「認証情報」に移動します
- 「認証情報を作成」>「OAuthクライアントID」をクリックします
- アプリケーションの種類として「デスクトップアプリ」を選択します
- 名前を付けて「作成」をクリックします
- GOOGLE_CLIENT_IDとGOOGLE_CLIENT_SECRETを取得します。
c. リフレッシュトークンを取得する:
- OAuth 2.0 プレイグラウンドへ
- 右上の歯車アイコン（設定）をクリックします
- 「独自のOAuth認証情報を使用する」をチェックします
- OAuthクライアントIDとクライアントシークレットを入力してください
- 左側のパネルで「Calendar API v3」を見つけて、「 https://www.googleapis.com/auth/calendar 」を選択します。
- 「APIを承認」をクリックしてOAuthフローを完了します
- 「認証コードをトークンに交換」をクリックします
- 「リフレッシュトークン」をコピーします。これがGOOGLE_REFRESH_TOKENです。
Claude Desktop で設定:

{
  "calendar": {
    "command": "npx",
    "args": [
      "@gongrzhe/server-calendar-mcp"
    ],
    "env": {
      "GOOGLE_CLIENT_ID": "your_client_id_here",
      "GOOGLE_CLIENT_SECRET": "your_client_secret_here",
      "GOOGLE_REFRESH_TOKEN": "your_refresh_token_here"
    }
  }
}

使用例

サーバーは、Claude デスクトップを通じて使用できるいくつかのツールを提供します。

イベントを作成

{
  "summary": "Team Meeting",
  "start": {
    "dateTime": "2024-01-20T10:00:00Z"
  },
  "end": {
    "dateTime": "2024-01-20T11:00:00Z"
  },
  "description": "Weekly team sync",
  "location": "Conference Room A"
}

イベント一覧

{
  "timeMin": "2024-01-01T00:00:00Z",
  "timeMax": "2024-12-31T23:59:59Z",
  "maxResults": 10,
  "orderBy": "startTime"
}

更新イベント

{
  "eventId": "event123",
  "summary": "Updated Meeting Title",
  "start": {
    "dateTime": "2024-01-20T11:00:00Z"
  },
  "end": {
    "dateTime": "2024-01-20T12:00:00Z"
  }
}

イベントを削除

{
  "eventId": "event123"
}

セキュリティノート

Google API 認証情報を安全に保つ
リフレッシュトークンを定期的にローテーションする
Claude Desktop構成で機密情報を保存する
資格情報をバージョン管理に共有したりコミットしたりしないでください
リフレッシュトークンはGoogleカレンダーへのアクセスを許可します。パスワードのように扱ってください。

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは ISC ライセンスに基づいてライセンスされています。

著者

ゴンジェ

サポート

問題が発生した場合や質問がある場合は、GitHub リポジトリに問題を報告してください。

Google Calendar