Calendar MCP Server

🚀 Google Calendar MCP サーバー

Google カレンダーの統合に使用される Claude デスクトップ Model Context Protocol (MCP) サーバーです。このサーバーは自然言語での対話を通じて、AI アシスタントが Google カレンダーのイベントを管理できるようにします。

✨ 主な機能

• タイトル、時間、説明、場所を持つカレンダーイベントを作成する
• イベント ID で詳細情報を取得する
• 既存のイベント（タイトル、時間、説明、場所）を更新する
• イベントを削除する
• 指定された期間内のイベントを一覧表示する
• Google カレンダー API を完全に統合する
• 安全な OAuth2 認証を行う

📦 インストール

Smithery を使用した自動インストール

Smithery を通じて Google カレンダーと Claude デスクトップの統合を自動インストールします。

npx -y @smithery/cli install @gongrzhe/server-calendar-mcp --client claude

手動インストール

npm install @gongrzhe/server-calendar-mcp

📚 ドキュメント

設定

1. Google Cloud プロジェクトを作成し、認証情報を取得します。

   a. Google Cloud プロジェクトを作成する：

   • Google Cloud Console にアクセスします。
   • 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
   • プロジェクトの Google カレンダー API を有効にします。

   b. OAuth 2.0 認証情報を作成する：

   • "APIs & Services" > "Credentials" に移動します。
   • "Create Credentials" > "OAuth client ID" をクリックします。
   • アプリケーションのタイプを "Desktop app" として選択します。
   • 名前を入力し、"Create" をクリックします。
   • クライアント ID とシークレットを取得します。

   c. OAuth2 を使用してアクセストークンを取得する：

   • Google API Console にアクセスします。
   • プロジェクトを作成し、カレンダー API を有効にします。
   • OAuth クライアント ID を追加します。
   • OAuth 2.0 トークンを生成します。

2. Claude デスクトップの設定に以下の内容を追加します。

{
  "calendar": {
    "enable": true,
    "apiKey": "あなたの Google カレンダー API キー",
    "clientId": "あなたのクライアント ID",
    "clientSecret": "あなたのクライアントシークレット"
  }
}

💻 使用例

基本的な使用法

カレンダーイベントの作成

{
  "summary": "会議のリマインダー",
  "start.dateTime": "2024-03-15T10:00:00+08:00",
  "end.dateTime": "2024-03-15T11:00:00+08:00"
}

イベントリストの取得

{
  "timeMin": "2024-03-15T00:00:00+08:00",
  "maxResults": 10
}

⚠️ 重要提示

• インストールが完了したら、Claude デスクトップを再起動して設定を適用してください。
• API キーとクライアントの認証情報を安全に保管し、漏洩を防いでください。
• セキュリティを強化するために、定期的にアクセストークンを更新してください。

🤝 貢献

貢献を歓迎します！いつでも Pull Request を送信してください。

📄 ライセンス

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

👤 作者

gongrzhe