Googleworkspace MCP Server

🚀 グーグルワークスペース MCP サーバー

このサーバーは、Model Context Protocol (MCP) を使用して、Gmail、Drive、Calendar、Docs、Sheets、Slides などのグーグルワークスペース API とやり取りするためのものです。

✨ 主な機能

• Gmail API：メールの送信、一覧表示、ラベルの管理など
• Drive API：ファイルの一覧表示、フォルダの作成、ファイルのアップロード
• Docs API：Google ドキュメントの作成と編集
• Sheets API：スプレッドシートデータの読み取りと書き込み
• Slides API：プレゼンテーションとスライドの作成
• Calendar API：カレンダーイベントの一覧表示と作成
• 認証：OAuth2 認証フローの補助ツール

📋 前提条件

• Node.js 16 以上
• 必要な API を有効にした Google Cloud プロジェクト
• OAuth 2.0 クライアント資格情報

📦 インストール

npm install

⚙️ 設定

1. .env.example ファイルを .env にコピーします。

   cp .env.example .env
   

2. Google API の資格情報を使用して .env ファイルを編集します。

   CLIENT_ID=your_client_id
   CLIENT_SECRET=your_client_secret
   REDIRECT_URI=http://localhost:3000/oauth2callback
   REFRESH_TOKEN=your_refresh_token
   

3. refresh token がない場合は、サーバーが提供する認証ツールを使用して取得できます。

💻 使用例

サーバーの起動

npm run dev

MCP Inspector との連携

MCP Inspector を使用してサーバーをテストするには、以下のコマンドを実行します。

npm run inspect

これにより、ブラウザで MCP Inspector が開き、すべてのツールとリソースをテストできます。

認証

refresh token がない場合は、以下の手順で取得できます。

1. generate_auth_url ツールを使用して認証 URL を取得します。
2. ブラウザでその URL を開き、アプリケーションを承認します。
3. リダイレクト URL から認証コードをコピーします。
4. exchange_code_for_tokens ツールとコードを使用して refresh token を取得します。
5. refresh token を .env ファイルに追加します。

利用可能なツール

Gmail

• gmail_list_messages：条件に合致する Gmail メールを一覧表示します。
• gmail_get_message：ID を指定して特定の Gmail メールを取得します。
• gmail_send_message：新しいメールを送信します。
• gmail_list_labels：すべての Gmail ラベルを一覧表示します。
• gmail_modify_message：メールのラベルを変更します。
• gmail_trash_message：メールをゴミ箱に移動します。
• gmail_untrash_message：ゴミ箱からメールを取り出します。
• gmail_create_draft：下書きを作成します。

Drive

• drive_list_files：Google Drive 内のファイルを一覧表示します。
• drive_get_file：特定のファイルのメタデータを取得します。
• drive_create_folder：Google Drive 内に新しいフォルダを作成します。
• drive_upload_file：ファイルを Google Drive にアップロードします。

Docs

• docs_get_document：Google ドキュメントの内容を取得します。
• docs_create_document：新しい Google ドキュメントを作成します。
• docs_append_text：ドキュメントの末尾にテキストを追加します。

Sheets

• sheets_get_values：Google スプレッドシートから値を読み取ります。
• sheets_update_values：スプレッドシート内の値を更新します。
• sheets_create_spreadsheet：新しい Google スプレッドシートを作成します。

Slides

• slides_create_presentation：新しい Google スライドプレゼンテーションを作成します。
• slides_get_presentation：プレゼンテーションの情報を取得します。
• slides_create_slide：プレゼンテーションに新しいスライドを追加します。

Calendar

• calendar_list_events：カレンダーイベントを一覧表示します。
• calendar_create_event：新しいカレンダーイベントを作成します。

📚 リソース

scheme://authority/path?query#fragment

例:

workspace://auth/guide