Google Calendar

🚀 Google Calendar MCP サーバー

このサーバーは、Google Calendar API と接続するための最小限の調整プロセッサ (MCP) サーバーです。Claude Desktop への統合に必要なインターフェースを提供します。

🚀 クイックスタート

サーバーを起動した後、http://localhost:3000 にアクセスしてドキュメントを確認します。

✨ 主な機能

• OAuth2 認証をサポート
• 複数のカレンダー操作エンドポイントを提供
• イベントの作成、読み取り、更新、削除をサポート
• 詳細なドキュメントと使用例を含む

📦 インストール

プロジェクト構造

google-calendar-mcp/
├── src/               # ソースコードディレクトリ
│   ├── server.js      # メインサーバーファイル
│   ├── routes/        # ルート定義
│   └── controllers/   # コントローラーロジック
├── .env              # 環境変数設定ファイル
├── Dockerfile       # Docker ビルド設定
└── package.json     # プロジェクト依存関係とスクリプト設定

依存関係のインストール

npm install
# または yarn を使用する場合
yarn install

環境変数

.env ファイルを作成し、以下の内容を追加します。

GOOGLE_CLIENT_ID=your_client_id_here
GOOGLE_CLIENT_SECRET=your_client_secret_here
PORT=3000  # オプション、デフォルトは3000

インストール手順

1. リポジトリをクローンします。

   git clone https://github.com/your-repository.git
   cd google-calendar-mcp
   

2. 依存関係をインストールします。

   npm install
   # または yarn
   

3. サーバーを起動します。

   npm start
   # または yarn start
   

💻 使用例

基本的な使用法

サーバーを起動した後、http://localhost:3000 にアクセスしてドキュメントを確認します。

高度な使用法

認証方法

2 種類の認証方法があります。

1. OAuth2 URL を通じて承認リンクを取得する

   curl http://localhost:3000/mcp/auth/url
   

2. 直接認証する

   curl -X POST http://localhost:3000/auth/direct
   

次に行われるイベントをクエリする

curl http://localhost:3000/mcp/events/upcoming

新しいイベントを作成する

リクエスト形式：

{
  "summary": "会議",
  "description": "重要な議論",
  "start": {
    "dateTime": "2024-01-15T10:00:00+08:00"
  },
  "end": {
    "dateTime": "2024-01-15T11:30:00+08:00"
  }
}

リクエストを送信する：

curl -X POST http://localhost:3000/mcp/events/create -H "Content-Type: application/json" -d '{"summary":"会議","description":"重要な議論","start":{"dateTime":"2024-01-15T10:00:00+08:00"},"end":{"dateTime":"2024-01-15T11:30:00+08:00"}}'

📚 ドキュメント

API エンドポイント

認証関連

• GET /mcp/auth/url：Google OAuth2 承認リンクを取得
• POST /mcp/auth/callback：OAuth2 コールバックを処理
• POST /auth/direct：直接認証

カレンダー操作

• GET /mcp/calendars：利用可能なすべてのカレンダーのリストを取得
• GET /mcp/events：指定されたカレンダーからイベントを取得
• GET /mcp/events/upcoming：すべてのカレンダーの次に行われるイベントを取得
• POST /mcp/events/create：新しいイベントを作成
• PUT /mcp/events/update：既存のイベントを更新
• DELETE /mcp/events/delete：イベントを削除
• GET /mcp/events/detail：特定のイベントの詳細を取得

サーバー情報

• GET /mcp/info：サーバー情報と利用可能なエンドポイントを取得
• GET /health：ヘルスチェックエンドポイント

テスト方法

テストを実行する：

npm test
# または yarn test

Docker デプロイ

イメージをビルドする：

docker build -t google-calendar-mcp .

コンテナを実行する：

docker run -p 3000:3000 --env-file .env google-calendar-mcp

🔧 技術詳細

セキュリティに関する考慮事項

• .env ファイルがバージョン管理システムにコミットされないようにする
• 本番環境では HTTPS を使用してデプロイする
• Google API キーと資格情報を定期的に更新する

トラブルシューティング

一般的な問題：

1. 認証に失敗した場合：GOOGLE_CLIENT_ID と GOOGLE_CLIENT_SECRET が正しいことを確認します。
2. カレンダーに接続できない場合：OAuth2 プロセスが完了し、有効なアクセストークンが取得されていることを確認します。

貢献ガイド

コードに貢献する方法：

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. 変更をコミットする
4. Pull Request を送信する

ドキュメントの履歴

• 1.0.0 は 2024年1月15日にリリースされました。