Googleカレンダー統合プロジェクト
このプロジェクトは、Google カレンダー API との統合を提供し、カレンダー イベントをプログラムで管理および操作します。
前提条件
- Python 3.8以上
- Google Cloud Platform アカウント
- GoogleカレンダーAPIが有効
- OAuth 2.0 認証情報が設定されている
セットアップ手順
- リポジトリのクローンを作成する
git clone https://github.com/Avik-creator/googlecalendarMCP
cd googlecalendarMCP
- 仮想環境のセットアップ
python -m venv venv
source venv/bin/activate # On Windows, use `venv\Scripts\activate`
- 依存関係をインストールする
pip install -r requirements.txt
- Google Cloud Platform のセットアップa. Google Cloud Consoleに移動します。b. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。c. Google Calendar API を有効にします。d. OAuth 2.0 認証情報を作成します。
- APIとサービス > 認証情報に移動します
- 「認証情報を作成」>「OAuthクライアントID」をクリックします
- 「デスクトップアプリケーション」を選択
- 資格情報JSONファイルをダウンロードする
- 名前を
credentials.json
に変更し、プロジェクトルートに配置します。
- 環境変数次の変数を含む
.env
ファイルをプロジェクト ルートに作成します。GOOGLE_APPLICATION_CREDENTIALS=path/to/credentials.json
CALENDAR_ID=your_calendar_id@group.calendar.google.com
使用法
- 初回認証OAuth認証用のブラウザウィンドウが開きます。指示に従ってアプリケーションを承認してください。
- アプリケーションの実行
特徴
- カレンダーイベントの作成、読み取り、更新、削除
- 定期的なイベントを設定する
- イベント参加者の管理
- イベント通知とリマインダーを処理する
プロジェクト構造
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認証情報を安全に保つ
- 認証情報とトークンを定期的にローテーションする
貢献
- リポジトリをフォークする
- 機能ブランチを作成する
- 変更をコミットする
- ブランチにプッシュする
- プルリクエストを作成する
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。