Google カレンダー MCP サーバー

TypeScript で構築され、Google カレンダーと統合されるモデルコンテキストプロトコル (MCP) サーバーです。

特徴

OAuth 2.0 認証による Google カレンダーのシームレスな統合
自動認証のための永続的なトークンストレージ
包括的なイベント操作でカレンダーを一覧表示および管理します
カレンダーイベントの作成、読み取り、更新、削除
指定した日付間のカレンダーイベントを取得します
リアルタイム更新のための Server-Sent Events (SSE) トランスポートオプション
Claude やその他の MCP 対応 AI アシスタントとのシンプルな統合

インストール

npm install -g mcp-google-calendar

または、次のコマンドを直接実行します:

npx -y mcp-google-calendar

前提条件

Node.js (v16 以上)
Google Cloud Platform アカウント
GoogleカレンダーAPIが有効
OAuth 2.0 認証情報

設定

1. Google Cloud の構成

Google Cloud Consoleに移動
新しいプロジェクトを作成するか、既存のプロジェクトを選択してください
Google カレンダー API を有効にします。
- 「APIとサービス」>「ライブラリ」に移動します
- 「Google カレンダー API」を検索
- 「有効にする」をクリックします
OAuth 同意画面を設定します。
- 「APIとサービス」>「OAuth同意画面」に移動します
- 「外部」ユーザータイプ（Google Workspace の場合は「内部」）を選択します
- 必要な情報を入力してください:
  - アプリ名: mcp-calendar
  - ユーザーサポートメール: (あなたのメールアドレス)
  - 開発者の連絡先情報: (メールアドレス)
- スコープを追加します:
  - 「スコープの追加または削除」をクリックします
  - 「 https://www.googleapis.com/auth/calendar.events 」を見つけて選択します
  - テストユーザーとしてメールアドレスを追加する
- セットアップを完了する
OAuth 資格情報を作成します。
- 「資格情報」へ移動
- 「認証情報を作成」>「OAuthクライアントID」をクリックします。
- アプリケーションの種類として「デスクトップアプリ」を選択します
- 名前を付けます（例：「MCP カレンダーデスクトップクライアント」）
- JSONファイルをダウンロードし、プロジェクトディレクトリにcredentials.jsonとして保存します。

2. 環境設定

プロジェクトルートに.envファイルを作成します。

# Server configuration
PORT=3420

# Google Calendar API configuration
CREDENTIALS_PATH=./credentials.json

使用法

サーバーの起動

標準の WebSocket から始めましょう:

npx -y mcp-google-calendar

サーバー送信イベント (SSE) から開始します。

npx -y mcp-google-calendar --sse

クロード・デスクトップ

これをclaude_desktop_config.jsonに追加します:

{
   "mcpServers": {
      "mcp-google-calendar": {
         "command": "npx",
         "args": ["-y", "mcp-google-calendar"],
         "env": {
            "CREDENTIALS_PATH": "/path/to/your/credentials.json"
         }
      }
   }
}

認証プロセス

サーバーを初めて実行する場合:

ブラウザウィンドウが自動的に開きます
Googleアカウントでログイン
要求されたカレンダーの権限を付与する
認証トークンはtoken.jsonに保存されます。

以降の起動時:

サーバーは保存されたトークンを自動的に使用します
トークンの有効期限が切れない限り、ブラウザの操作は必要ありません

利用可能なツール

道具	説明
`list_calendars`	利用可能なすべてのカレンダーを取得する
`list_calendar_events`	指定した日付間のイベントを取得する
`create_calendar_event`	カレンダーに新しいイベントを追加する
`get_calendar_event`	特定のイベントの詳細を取得する
`edit_calendar_event`	既存のカレンダーイベントを変更する
`delete_calendar_event`	カレンダーからイベントを削除する

発達

プロジェクトのクローンを作成してセットアップします。

git clone https://github.com/am2rican5/mcp-google-calendar.git
cd mcp-google-calendar
npm install

プロジェクトをビルドします。

npm run build

開発モードで実行:

npm start

セキュリティに関する考慮事項

⚠️重要なセキュリティ警告⚠️

credentials.jsonとtoken.jsonには機密の認証情報が含まれています
これらのファイルをバージョン管理にコミットしたり、公開したりしないでください。
各ユーザーは独自のOAuth認証情報を作成する必要があります
認証情報が侵害された疑いがある場合は、Google Cloud Console で直ちに取り消してください。
トークンはGoogleカレンダーデータへのアクセスを許可します

ライセンス

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

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

リポジトリをフォークする
機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
変更をコミットします ( git commit -m 'Add some amazing feature' )
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

Google Calendar MCP Server