Gongrzhe Calendar MCP Server

🚀 Google Calendar MCP サーバー

このサーバーは、Googleカレンダーとの統合を目的としたClaude Desktopモデルのコンテキストプロトコル（MCP）サーバーです。AIアシスタントが自然言語でGoogleカレンダーのイベントを管理できるようになります。

✨ 主な機能

• タイトル、時間、説明、場所を指定してカレンダーイベントを作成する
• イベントIDを使ってイベントの詳細情報を取得する
• 既存のイベント（タイトル、時間、説明、場所）を更新する
• イベントを削除する
• 指定した期間内のイベントを一覧表示する
• GoogleカレンダーAPIと完全に統合する
• 安全なOAuth2認証を行う

📦 インストール

Smitheryを通じたインストール

Smitheryを通じてClaude DesktopのGoogleカレンダー統合を自動インストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @gongrzhe/server-calendar-mcp --client claude

手動インストール

以下のコマンドを実行して手動でインストールします。

npm install @gongrzhe/server-calendar-mcp

📚 ドキュメント

設定

1. Google Cloudプロジェクトを作成し、認証情報を取得します。 a. Google Cloudプロジェクトを作成する：
   • Google Cloud Consoleにアクセスします。
   • 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
   • プロジェクトのGoogleカレンダーAPIを有効にします。 b. OAuth 2.0認証情報を作成する：
   • 「APIs & Services」>「Credentials」に移動します。
   • 「Create credentials」>「OAuth client ID」をクリックします。
   • アプリケーションタイプとして「Desktop app」を選択します。
   • 名前を入力し、「Create」をクリックします。
   • GOOGLE_CLIENT_IDとGOOGLE_CLIENT_SECRETを取得します。 c. リフレッシュトークンを取得する：
   • OAuth 2.0 Playgroundにアクセスします。
   • 右上の歯車アイコン（設定）をクリックします。
   • 「Use your own OAuth credentials」を有効にします。
   • OAuthクライアントIDとクライアントシークレットを入力します。
   • 左側のパネルで「Calendar API v3」を見つけ、"https://www.googleapis.com/auth/calendar"を選択します。
   • 「Authorize APIs」をクリックし、OAuthフローを完了させます。
   • 「Exchange authorization code for tokens」をクリックします。
   • 「Refresh token」をコピーします - これがあなたのGOOGLE_REFRESH_TOKENです。
2. Claude Desktopで設定する：

{
  "calendar": {
    "command": "npx",
    "args": [
      "@gongrzhe/server-calendar-mcp"
    ],
    "env": {
      "GOOGLE_CLIENT_ID": "your_client_id_here",
      "GOOGLE_CLIENT_SECRET": "your_client_secret_here",
      "GOOGLE_REFRESH_TOKEN": "your_refresh_token_here"
    }
  }
}

💻 使用例

カレンダーイベントの作成

# 新しいカレンダーを作成する
curl -X POST http://localhost:3000/calendars \
  -H 'Content-Type: application/json' \
  -d '{"name": "My Calendar"}'

# 指定したカレンダー内にイベントを作成する
curl -X POST http://localhost:3000/calendars/[CALENDAR_ID]/events \
  -H 'Content-Type: application/json' \
  -d '{"summary": "Meeting", "start": {"dateTime": "2024-01-01T10:00:00"}, "end": {"dateTime": "2024-01-01T11:00:00"}}'

イベントの取得

# すべてのカレンダーを取得する
curl http://localhost:3000/calendars

# 特定のカレンダーのイベントを取得する
curl http://localhost:3000/calendars/[CALENDAR_ID]/events

⚠️ 重要提示

• リフレッシュトークンはGoogleカレンダーへのアクセス権を与えるため、慎重に保管してください。
• 認証情報をバージョン管理システムにコミットしないでください。
• APIキーを定期的に更新し、管理してセキュリティを確保してください。

🔧 貢献ガイド

貢献を歓迎します！自由にPull Requestを送信してください。

📄 ライセンス

このプロジェクトはISCライセンスの下で提供されています。

👤 作者

gongrzhe