MCP Server Google Calendar

🚀 モデルコンテキストプロトコル（MCP）に基づくGoogleカレンダーサーバー

このサーバーは、Model Context Protocol（MCP）に基づいたGoogle Calendar統合サーバーです。Claude DesktopのようなMCPクライアントがGoogle Calendarに予定を追加することをサポートしています。

🚀 クイックスタート

このサーバーは、Model Context Protocol（MCP）に基づいて構築されており、Claude DesktopなどのMCPクライアントがGoogle Calendarに予定を追加できるようにします。以下の手順に従って、サーバーをセットアップしてください。

✨ 主な機能

• Google OAuth 2.0認証
• Google Calendar予定の作成
• 期間指定でのGoogle Calendar予定の照会をサポート
• 現在の日付の取得
• 韓国時間（KST）をサポート
• 詳細なエラー処理とログ記録

📦 インストール

リポジトリのクローン

git clone [リポジトリのURL]
cd mcp-server-google-calendar

依存関係のインストール

npm install

環境変数の設定

.envファイルを作成し、以下の内容を追加してください。

GOOGLE_CLIENT_ID=あなたのクライアントID
GOOGLE_CLIENT_SECRET=あなたのクライアントシークレット

📚 ドキュメント

Google Cloud Consoleの設定

1. Google Cloud Consoleにアクセスし、新しいプロジェクトを作成します。
2. Google Calendar APIを有効にします。
3. OAuth 2.0クライアントIDを作成します。
   • アプリケーションの種類: "デスクトップアプリケーション" を選択します。
   • 生成されたクライアントIDとシークレットを.envファイルに追加します。

Claude Desktopの設定

1. Claude Desktopをインストールします。
   • Claude Desktopのダウンロード
   • MCP機能はデスクトップアプリケーションでのみ利用可能です。
2. MCPサーバーを設定します。 ~/Library/Application Support/Claude/claude_desktop_config.jsonファイルを作成または編集し、以下の内容を追加します。

   {
     "mcp-server-google-calendar": {
       "command": "/usr/local/bin/node",
       "args": ["/{絶対パス}/mcp-server-google-calendar/dist/main.js"],
       "env": {
         "GOOGLE_CLIENT_ID": "あなたのクライアントID",
         "GOOGLE_CLIENT_SECRET": "あなたのクライアントシークレット"
       }
     }
   }
   

3. Claude Desktopを起動した後、設定の "MCPサービス" タブにアクセスし、この新しいサービスを有効にします。

利用可能なツール

• カレンダー管理：予定の作成、読み取り、更新、削除ができます。
• 時間照会：現在の日付と時刻を取得できます（KSTをサポート）。
• リマインダー機能：リマインダーを設定し、管理できます。
• マルチデバイス同期：異なるデバイス間で予定を同期できます。

デバッグ

1. 開発者ツールを有効にします。

   echo '{"allowDevTools": true}' > ~/Library/Application\ Support/Claude/developer_settings.json
   

2. 開発者モードでCommand-Option-Shift-iを押して、デバッグツールを開きます。

エラー処理

サーバーは、以下の状況で適切なエラーメッセージを返します。

• Google認証が必要な場合
• 時間形式が誤っている場合
• 必須パラメータが欠落している場合
• Google Calendar APIの呼び出しが失敗した場合

ログ記録

サーバーはPinoロガーを使用して、以下の情報を記録します。

• サーバーの起動と停止
• ツールの呼び出しと応答
• 認証プロセス
• エラーと例外の状況

開発環境の設定

1. TypeScriptのビルド

npm run build

2. 開発モードの起動（自動再起動）

npm run dev

3. コードチェック

npm run lint

問題解決

サーバー接続問題

• Claude Desktopのログを確認します。
• サーバープロセスが実行されていることを確認します。
• 環境変数の設定を確認します。
• 絶対パスを使用していることを確認します。

認証問題

• Google Cloud ConsoleでAPIが有効になっていることを確認します。
• クライアントIDとシークレットを再確認します。
• OAuth同意画面の設定を確認します。

📄 ライセンス

MITライセンス