Google Calendar Oic

🚀 Google Calendar MCP サーバーツール説明ドキュメント

このツールはGoogle CalendarにMCP（マシン対マシンプロトコル）インターフェースを提供します。このインターフェースを通じて、以下の操作を実行できます。

1. イベントの作成：createEvent ツールを使用して、カレンダーに新しい予定を追加します。
2. イベントの更新：updateEvent ツールを利用して、既存のイベントの詳細情報を変更します。
3. イベントの削除：deleteEvent ツールを通じて、特定の予定を削除します。
4. カレンダーリストの取得：getCalendars ツールを使用して、すべてのアクセス可能なカレンダーを取得します。
5. 認証ツール：新しく authenticate ツールが追加され、Claudeを再起動することなく異なるGoogleアカウントを切り替えることができます。

🚀 クイックスタート

このツールを使用することで、Google Calendar上で様々な操作を簡単に行うことができます。以下に使用方法や機能の詳細を説明します。

✨ 主な機能

• イベント操作：作成、更新、削除の各操作が可能です。
• カレンダー管理：すべてのアクセス可能なカレンダーを取得できます。
• 認証機能：Claudeを再起動することなくGoogleアカウントを切り替えられます。

📦 インストール

このドキュメントではインストールに関する内容は提供されていません。

💻 使用例

基本的な使用法

MCPメッセージ形式

MCP通信はJSON - RPCプロトコルを使用しており、具体的なリクエスト形式は次の通りです。

{
  "jsonrpc": "2.0",
  "method": "tool.name",
  "params": {
    "calendarId": "primary", // カレンダーID、デフォルトは"primary"
    "event": { ... }, // 具体的なイベント情報
    ...
  },
  "id": 1
}

ツール説明

createEvent

• 機能：新しい予定を作成します。
• パラメータ：
  • calendarId（オプション）：対象のカレンダーを指定します。デフォルトは "primary" です。
  • event：イベントの詳細情報を含むオブジェクトで、summary、description、start、end フィールドを含む必要があります。

updateEvent

• 機能：既存のイベントの情報を更新します。
• パラメータ：
  • eventId：変更するイベントのIDです。
  • calendarId（オプション）：対象のカレンダーで、デフォルトは "primary" です。
  • event：更新するフィールドを含むオブジェクトで、提供されないフィールドは元の値のままになります。

deleteEvent

• 機能：指定された予定を削除します。
• パラメータ：
  • eventId：削除するイベントのIDです。
  • calendarId（オプション）：対象のカレンダーで、デフォルトは "primary" です。

getCalendars

• 機能：すべてのアクセス可能なカレンダーのリストを取得します。
• 戻り値：カレンダーIDと名前を含むオブジェクトの配列です。

📚 ドキュメント

バージョン履歴

バージョン1.0.6の更新内容

• 不要な承認範囲 (scope) 設定を削除し、Google Calendar APIとの統合を最適化しました。

バージョン1.0.5の更新内容

• 新機能：
  • createEvent と updateEvent で recurrence パラメータを使用して、繰り返しイベントを直接作成および変更できるようになりました。
  • ユーザーが手動で設定することなく繰り返し予定を管理できるようになりました。

バージョン1.0.4の更新内容

• メンテナンスバージョンの更新で、最新の依存関係との互換性を維持しました。
• 機能的な変更はありませんが、内部コード構造を最適化しました。

バージョン1.0.3の更新内容

• 新機能：

  • authenticate ツールを導入し、実行時に再認証をサポートします。
  • アカウント切り替え機能を実装し、Claudeを再起動することなくGoogleアカウントを変更できます。
  • localhostにアクセスできない環境に対応した手動認証オプションを提供します。
  • ユーザーが承認コードを入力しやすいようにコンソールインターフェースを追加しました。

• 最適化と改善：

  • zod依存関係を最新バージョン（3.24.2）に更新しました。
  • 複数の潜在的なセキュリティとパフォーマンスの問題を修正しました。

バージョン1.0.2の更新内容

• カレンダーアクセス権限エラーの原因となる可能性のあるバグを修正しました。

貢献ガイド

• コードリポジトリ：このプロジェクトはGitHubにホストされています。
• 問題の報告：Github Issuesを使用して、問題を報告したり提案を行ったりできます。
• 開発への参加：リポジトリをForkしてPull Requestを送ることを歓迎します。

テストガイド

• テスト要件：

  • 有効なGoogle Calendarアカウントを持っていることを確認してください。
  • 正しいAPIキーと承認権限を設定してください。

• テスト方法：

npm test

📄 ライセンス

このプロジェクトはMIT Licenseに従い、ソースコードはGithubで入手できます。

何か問題があれば、サポートチームに連絡するか、公式ドキュメントを参照してください。