Google Calendar MCP Server

Integrations

  • Provides tools for managing Google Calendar, including listing calendars, creating/reading/updating/deleting events, and fetching events between specified dates with OAuth 2.0 authentication.

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

前提条件

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

設定

1. Google Cloud の構成

  1. Google Cloud Consoleに移動
  2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください
  3. Google カレンダー API を有効にします。
    • 「APIとサービス」>「ライブラリ」に移動します
    • 「Google カレンダー API」を検索
    • 「有効にする」をクリックします
  4. OAuth 同意画面を設定します。
    • 「APIとサービス」>「OAuth同意画面」に移動します
    • 「外部」ユーザータイプ(Google Workspace の場合は「内部」)を選択します
    • 必要な情報を入力してください:
      • アプリ名: mcp-calendar
      • ユーザーサポートメール: (あなたのメールアドレス)
      • 開発者の連絡先情報: (メールアドレス)
    • スコープを追加します:
    • セットアップを完了する
  5. 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" } } } }

認証プロセス

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

  1. ブラウザウィンドウが自動的に開きます
  2. Googleアカウントでログイン
  3. 要求されたカレンダーの権限を付与する
  4. 認証トークンは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.jsontoken.jsonには機密の認証情報が含まれています
  • これらのファイルをバージョン管理にコミットしたり、公開したりしないでください。
  • 各ユーザーは独自のOAuth認証情報を作成する必要があります
  • 認証情報が侵害された疑いがある場合は、Google Cloud Console で直ちに取り消してください。
  • トークンはGoogleカレンダーデータへのアクセスを許可します

ライセンス

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

貢献

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

  1. リポジトリをフォークする
  2. 機能ブランチを作成します( git checkout -b feature/amazing-feature
  3. 変更をコミットします ( git commit -m 'Add some amazing feature' )
  4. ブランチにプッシュする ( git push origin feature/amazing-feature )
  5. プルリクエストを開く
-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

モデル コンテキスト プロトコルを通じて Google カレンダーを AI アシスタントと統合し、ユーザーが自然言語による対話を通じてカレンダー イベントを表示および管理できるようにします。

  1. 特徴
    1. インストール
      1. 前提条件
        1. 設定
          1. 1. Google Cloud の構成
          2. 2. 環境設定
        2. 使用法
          1. サーバーの起動
          2. クロード・デスクトップ
          3. 認証プロセス
        3. 利用可能なツール
          1. 発達
            1. セキュリティに関する考慮事項
              1. ライセンス
                1. 貢献

                  Related MCP Servers

                  • -
                    security
                    F
                    license
                    -
                    quality
                    Google Calendar integration in Cursor IDE. This server enables AI assistants to manage Google Calendar events through natural language interactions.
                    Last updated -
                    5
                    0
                    5
                    JavaScript
                  • -
                    security
                    A
                    license
                    -
                    quality
                    Server for Google Calendar integration in Cluade Desktop with auto authentication support. This server enables AI assistants to manage Google Calendar events through natural language interactions.
                    Last updated -
                    22
                    6
                    JavaScript
                    MIT License
                  • -
                    security
                    F
                    license
                    -
                    quality
                    Allows interaction with Google Calendar through Claude Desktop using the Model Context Protocol, enabling calendar event management and schedule analysis.
                    Last updated -
                    2
                    JavaScript
                    • Apple
                  • -
                    security
                    A
                    license
                    -
                    quality
                    A Model Context Protocol server that integrates Google Calendar with Claude Desktop, enabling users to manage calendar events (view, create, update, delete) through natural language.
                    Last updated -
                    133
                    21
                    TypeScript
                    MIT License

                  View all related MCP servers

                  ID: 0j32839h00