Gongrzhe Calendar Autoauth MCP Server

🚀 GoogleカレンダーAutoAuth MCPサーバー

Claude DesktopにGoogle Calendarを統合するためのModel Context Protocol (MCP) サーバーで、自動認証をサポートしています。このサーバーは、カレンダーイベントの作成、読み取り、更新、削除機能を提供します。

✨ 主な機能

• イベント作成：タイトル、開始時間、終了時間、説明、場所を指定できます。
• イベント一覧表示：時間範囲を指定して特定の期間内のカレンダーイベントを照会でき、開始時間でのソートもサポートしています。
• イベント更新：イベントのタイトル、時間、その他の属性を変更できます。
• イベント削除：イベントIDを指定して削除できます。

📦 インストール

1. サーバーのダウンロード

GitHubリポジトリからMCPサーバーをダウンロードします。

git clone https://github.com/yourusername/calendar-mcp-server.git
cd calendar-mcp-server

2. 依存関係のインストール

必要なPythonパッケージをインストールします。

pip install google-auth google-auth-oauthlib googleapis-common-protos google-resumable-media

3. カレンダーAPIの設定

Google Cloud Consoleでプロジェクトを作成し、カレンダーAPIを有効にします。service-account.jsonファイルをダウンロードし、プロジェクトのルートディレクトリに配置します。

💻 使用例

基本的な使用法

イベントの作成

{
  "summary": "チーム会議",
  "start": {
    "dateTime": "2024-01-20T10:00:00Z"
  },
  "end": {
    "dateTime": "2024-01-20T11:00:00Z"
  },
  "description": "毎週のチーム同期会",
  "location": "A会議室"
}

イベントの一覧表示

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

イベントの更新

{
  "eventId": "event123",
  "summary": "更新後の会議タイトル",
  "start": {
    "dateTime": "2024-01-20T11:00:00Z"
  },
  "end": {
    "dateTime": "2024-01-20T12:00:00Z"
  }
}

イベントの削除

{
  "eventId": "event123"
}

📚 ドキュメント

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

⚠️ 重要提示

• OAuth認証情報のセキュリティ：service-account.jsonファイルが漏洩したり、バージョン管理システムにコミットされないようにしてください。
• 権限管理：使用されなくなったAPIアクセス権限を定期的に確認し、削除してください。

トラブルシューティング

問題1：Google Calendarに接続できない場合

• ネットワークが正常に接続されていることを確認し、カレンダーAPIが正しく有効になっており、サービスアカウントに適切な権限があることを確認してください。

問題2：時間形式が誤っている場合

• すべての時間フィールドがISO 8601標準形式（例："2024-01-20T10:00:00Z"）に従っていることを確認してください。

コントリビューション

どんなコントリビューションも歓迎します！Pull Requestを送信してプロジェクト開発に参加してください。

📄 ライセンス

このプロジェクトはISCライセンスの下で提供されています。

作者

gongrzhe