MCP Google Calendar Server

🚀 谷歌日历模型上下文协议サーバー（Google Calendar MCP Server）

このプロジェクトは、Googleカレンダーとのやり取りを行うサーバーサイドプロジェクトです。カレンダーイベントの作成、読み取り、更新、削除、および空き時間の検索が可能です。Node.jsで記述され、OAuth 2.0を使用して認証されます。

✨ 主な機能

• イベントの作成：新しいカレンダーイベントを追加します。
• イベントの読み取り：指定された期間内のすべてのイベントを取得します。
• イベントの更新：既存のイベントの詳細情報を変更します。
• イベントの削除：特定のカレンダーイベントを削除します。
• 空き時間の検索：指定された期間内で利用可能な時間枠を検索します。

📦 インストール

1. 準備

• プロジェクトファイルをダウンロードし、目的のディレクトリに解凍します。
• Node.js（推奨バージョン8.0以上）とnpmがインストールされていることを確認します。

2. 依存関係のインストール

プロジェクトのルートディレクトリで以下のコマンドを実行します。

npm install

3. 環境変数の設定

.env.exampleファイルを.envにコピーし、以下の内容を実際の情報に置き換えて記入します。

CLIENT_ID=あなたのクライアントID
CLIENT_SECRET=あなたのクライアントシークレット
REDIRECT_URI=リダイレクトURL（例：http://localhost:3000/oauth2callback）
REFRESH_TOKEN=取得したリフレッシュトークン

💻 使用例

1. HTTP/SSEサーバーとして使用

プロジェクトのルートディレクトリで以下のコマンドを実行してサービスを起動します。

npm run start:http

デフォルトではhttp://localhost:3334でリッスンします。

2. CLIツールとして使用

以下のコマンドを実行してコンソールモードで起動します。

npm run start:stdio

基本的な使用法

イベントの作成

{
  "summary": "会議",
  "description": "重要なプロジェクトに関する議論会",
  "start": {
    "dateTime": "2023-10-10T09:00:00+08:00"
  },
  "end": {
    "dateTime": "2023-10-10T11:00:00+08:00"
  }
}

高度な使用法

リフレッシュトークンの取得

手順説明

1. 以下のスクリプトを実行して認証フローを開始します。

const { google } = require('googleapis');
const http = require('http');
const url = require('url');

// 実際の情報に置き換えてください
const CLIENT_ID = 'あなたのクライアントID';
const CLIENT_SECRET = 'あなたのクライアントシークレット';
const REDIRECT_URI = 'http://localhost:3000/oauth2callback';

const oauth2Client = new google.auth.OAuth2(
  CLIENT_ID,
  CLIENT_SECRET,
  REDIRECT_URI
);

const scopes = [
  'https://www.googleapis.com/auth/calendar',
  'https://www.googleapis.com/auth/calendar.events'
];

function getRefreshToken() {
  const server = http.createServer(async (req, res) => {
    const queryParams = url.parse(req.url, true).query;
    
    if (queryParams.code) {
      try {
        const { tokens } = await oauth2Client.getToken(queryParams.code);
        console.log('リフレッシュトークン:', tokens.refresh_token);
        res.end('認証成功！このウィンドウを閉じて構いません。');
        server.close();
      } catch (error) {
        console.error('トークンの取得に失敗しました:', error);
        res.end('認証失敗！');
      }
    }
  }).listen(3000, () => {
    const authUrl = oauth2Client.generateAuthUrl({
      access_type: 'offline',
      scope: scopes,
      prompt: 'consent'
    });

    console.log('ブラウザで以下のURLを開いてください:');
    console.log(authUrl);
  });
}

getRefreshToken();

2. スクリプトの出力に表示されるURLをブラウザで開き、指示に従って認証フローを完了します。
3. 認証が完了すると、コンソールに新しいリフレッシュトークンが表示されます。

開発とデバッグ

npm run dev

📚 ドキュメント

よくある問題の解決策

• 認証エラー：クライアントID、シークレット、およびリダイレクトURIが正しく設定されていることを確認してください。
• サーバーの起動に失敗した場合：ポートが使用中でないこと、または権限設定が正しいことを確認してください。

📄 ライセンス

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