Googleカレンダー統合プロジェクト

このプロジェクトは、Google カレンダー API との統合を提供し、カレンダー イベントをプログラムで管理および操作します。

前提条件

• Python 3.8以上

• Google Cloud Platform アカウント

• GoogleカレンダーAPIが有効

• OAuth 2.0 認証情報が設定されている

Related MCP server: Google Calendar AutoAuth MCP Server

セットアップ手順

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Google カレンダー統合プロジェクトを自動的にインストールするには:

npx -y smithery install @Avik-creator/googlecalendarMCP --client claude

手動インストール

1. リポジトリのクローンを作成する

   git clone https://github.com/Avik-creator/googlecalendarMCP
   cd googlecalendarMCP

2. 仮想環境の設定

   python -m venv venv
   source venv/bin/activate  # On Windows, use `venv\Scripts\activate`

3. 依存関係をインストールする

   pip install -r requirements.txt

4. Google Cloud Platform のセットアップ

   a. Google Cloud Consoleに移動します。b. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。c. Google Calendar API を有効にします。d. OAuth 2.0 認証情報を作成します。

   • APIとサービス > 認証情報に移動します

   • 「認証情報を作成」>「OAuthクライアントID」をクリックします

   • 「デスクトップアプリケーション」を選択

   • 資格情報JSONファイルをダウンロードする

   • 名前をcredentials.jsonに変更し、プロジェクトルートに配置します。

5. 環境変数

   次の変数を含む.envファイルをプロジェクト ルートに作成します。

   GOOGLE_APPLICATION_CREDENTIALS=path/to/credentials.json
   CALENDAR_ID=your_calendar_id@group.calendar.google.com

使用法

1. 初回認証

   python auth.py

   OAuth認証用のブラウザウィンドウが開きます。指示に従ってアプリケーションを承認してください。

2. アプリケーションの実行

   python main.py

特徴

• カレンダーイベントの作成、読み取り、更新、削除

• 定期的なイベントを設定する

• イベント参加者の管理

• イベント通知とリマインダーを処理する

プロジェクト構造

googlecalendarMCP/
├── auth.py              # Authentication handling
├── main.py             # Main application entry point
├── requirements.txt    # Project dependencies
├── .env               # Environment variables
├── credentials.json   # Google OAuth credentials
└── token.json        # Generated OAuth token

依存関係

このプロジェクトでは、主に次の依存関係を使用します。

• Google 認証 OAuth ライブラリ

• google-auth-httplib2

• Google API Python クライアント

• Python-dotenv

展開された構成:

{
  "mcpServers": {
    "google_calendar_mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-google-calendar.avikm744.workers.dev/sse"
      ]
    }
  }
}

セキュリティノート

• credentials.json 、 token.json 、 .envファイルをバージョン管理にコミットしないでください。

• OAuth認証情報を安全に保つ

• 認証情報とトークンを定期的にローテーションする

貢献

1. リポジトリをフォークする

2. 機能ブランチを作成する

3. 変更をコミットする

4. ブランチにプッシュする

5. プルリクエストを作成する

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。