NG

nspady/google-calendar-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

1207 stars 336 forks 品質 87 トレンド 43MIT

イベント管理のためのGoogleカレンダーのMCP統合。

概要

ClaudeのようなAIアシスタント向けにGoogleカレンダー統合を提供するモデルコンテキストプロトコル(MCP)サーバーです。 - : 複数のGoogleアカウント(例:仕事用、個人用)を接続し、同時にクエリを行使 - : 複数のカレンダーのイベントを1回のリクエストでリストアップ - : 任意のカレンダーの組み合わせで重複するイベントを検出 - : カレンダーイベントの作成、更新、削除、検索 - : 繰り返し発生するイベントの高度な修正機能 - : カレンダー間の利用可能性を確認 - : 日付や時間の自然言語理解 - : 画像、PDF、ウェブリンクからカレンダーイベントを追加 1. カレンダーAPIが有効なGoogle Cloudプロジェクト 2.OAuth 2.0の認証情報(デスクトップアプリタイプ) 1. Google Cloud Consoleにアクセスする 2.新しいプロジェクトを作成するか、既存のプロジェクトを選択する。3. プロジェクト用のGoogleカレンダーAPIを有効にする。APIを有効にする前に、上部バーから正しいプロジェクトを選択していることを確認してください。4. OAuthを作成する 2.

概要(AI 翻訳)

ClaudeのようなAIアシスタント向けにGoogleカレンダー統合を提供するモデルコンテキストプロトコル(MCP)サーバーです。

また、チャット用に欲しかったカレンダー統合「Cocal」も作りました。Claude内のビジュアルカレンダーで、提案された時間帯の1日全体を表示し、会話から管理する予約リンクや招待も管理できます。これはホスティングされているので、Google Cloudの設定なしでデスクトップとモバイルの両方で動作します。

リアルCocal UIとサンプルカレンダーデータ。どちらかのスクリーンショットをクリックすると拡大表示されます。 コカル→を試してみてください


特徴

  • マルチアカウントサポート:複数のGoogleアカウント(例:仕事用、個人用)を接続し、同時にクエリを行使
  • マルチカレンダーサポート:複数のカレンダーのイベントを1つのリクエストでリストアップ
  • アカウント間競合:任意のカレンダーの組み合わせで重複するイベントを検出
  • イベント管理:カレンダーイベントの作成、更新、削除、検索
  • 定期イベント:繰り返しイベントのための高度な修正機能
  • 空き/混雑中のクエリ:カレンダー間の空き状況を確認する
  • スマートスケジューリング:日付や時間の自然言語理解
  • インテリジェントインポート:画像、PDF、ウェブリンクからカレンダーイベントを追加

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Google Calendar MCP Server

A Model Context Protocol (MCP) server that provides Google Calendar integration for AI assistants like Claude.


Features

  • Multi-Account Support: Connect multiple Google accounts (e.g., work, personal) and query them simultaneously
  • Multi-Calendar Support: List events from multiple calendars in a single request
  • Cross-Account Conflicts: Detect overlapping events across any combination of calendars
  • Event Management: Create, update, delete, and search calendar events
  • Recurring Events: Advanced modification capabilities for recurring events
  • Free/Busy Queries: Check availability across calendars
  • Smart Scheduling: Natural language understanding for dates and times
  • Intelligent Import: Add calendar events from images, PDFs, or web links

Quick Start

Don’t want to set up a Google Cloud project? Cocal is a hosted option that works in Claude on desktop and mobile.

Prerequisites

  1. A Google Cloud project with the Calendar API enabled
  2. OAuth 2.0 credentials (Desktop app type)

Google Cloud Setup

  1. Go to the Google Cloud Console
  2. Create a new project or select an existing one.
  3. Enable the Google Calendar API for your project. Ensure that the right project is selected from the top bar before enabling the API.
  4. Create OAuth 2.0 credentials:
    • Go to Credentials
    • Click “Create Credentials” > “OAuth client ID”
GitHub で README 全文を見る

インストール

npx @cocal/google-calendar-mcp
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "google-calendar": { "command": "npx", "args": ["@cocal/google-calendar-mcp"], "env": { "GOOGLE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json" } } } }