Google Calendar

🚀 谷歌日历 MCP プロジェクトガイド

このガイドでは、Model Context Protocol (MCP) を利用して Google Calendar と統合されたツールを作成する方法を詳細に説明します。このツールを使用すると、Claude 内で自然言語処理を通じてカレンダーイベントを管理および照会することができます。

🚀 クイックスタート

プロジェクトの初期化

mkdir google-calendar-mcp
cd google-calendar-mcp
npm init -y

依存関係のインストール

npm install @modelcontextprotocol/sdk googleapis google-auth-library zod
npm install -D @types/node typescript

tsconfig.json ファイルの作成

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "Node16",
    "moduleResolution": "Node16",
    "outDir": "./build",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

package.json の更新

{
  "type": "module",
  "scripts": {
    "build": "tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\""
  }
}

✨ 主な機能

1. list_events：指定された期間内のカレンダーイベントをリストします。
2. create_event：新しいカレンダーイベントを作成します。
3. update_event：既存のカレンダーイベントを更新します。
4. delete_event：カレンダーイベントを削除します。
5. find_free_time：利用可能な時間帯を検索します。

📦 インストール

環境要件

• オペレーティングシステム：Node.js をサポートする任意のオペレーティングシステム（Linux または macOS を推奨）
• Node.js バージョン：16.0+
• npm バージョン：6.0+

認証設定

OAuth 認証情報の取得

1. OAuth アプリの作成：
   • Google Cloud Console にログインします。
   • 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
   • "APIs & Services" > "Credentials" に移動します。
   • "Create Credentials" をクリックし、"OAuth client ID" を選択します。
2. OAuth スコープの設定：
   • 以下のスコープを要求します：https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/calendar

環境変数の設定

.env ファイルを作成します（バージョン管理システムにはコミットしないでください）：

GOOGLE_CLIENT_ID=your_client_id_here
GOOGLE_CLIENT_SECRET=your_client_secret_here
GOOGLE_REDIRECT_URI=http://localhost
GOOGLE_REFRESH_TOKEN=your_refresh_token_here

プロジェクト構造の作成

mkdir src

💻 使用例

基本的な使用法

依存関係のインポート

src/index.ts で必要なモジュールをインポートします：

import { GoogleCalendar } from '@modelcontextprotocol/google-calendar';

カレンダーツールの初期化

MCP ツールクラスを作成します：

export class GoogleCalendarMCP extends Tool {
  private calendar: Calendar;

  constructor() {
    super('google_calendar', 'Google Calendar Management');
    this.calendar = new Calendar({
      client_id: process.env.GOOGLE_CLIENT_ID,
      client_secret: process.env.GOOGLE_CLIENT_SECRET,
      redirect_uri: process.env.GOOGLE_REDIRECT_URI,
      refresh_token: process.env.GOOGLE_REFRESH_TOKEN
    });
  }

  // 他のツールメソッド（listEvents, createEvent など）を実装します
}

ビルドと実行

npm run build

📚 ドキュメント

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

• OAuth 認証情報の安全性を確保し、バージョン管理システムにコミットしないでください。
• 定期的にリフレッシュトークンを更新してください。
• Google Cloud Console で API の使用状況を監視してください。

サポートとフィードバック

問題が発生した場合は、以下の手順に従ってください：

1. トラブルシューティングのセクションを参照してください。
2. Claude Desktop のログを確認してください。
3. GitHub で問題を作成してください。
4. メンテナに連絡してください。