Google Workspace MCP Server

Google Workspace MCP サーバー

Gmail、Drive、Calendar、Docs、Sheets、Slides などの Google Workspace API と連携する Model Context Protocol（MCP）サーバーです。

## 特長

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

## 前提条件

- Node.js 16+
- 必要な API を有効にした Google Cloud プロジェクト
- OAuth 2.0 クライアント認証情報

## インストール

```bash
npm install
```

## 設定

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

2. `.env` ファイルに Google API の認証情報を設定します。
   ```
   CLIENT_ID=your_client_id
   CLIENT_SECRET=your_client_secret
   REDIRECT_URI=http://localhost:3000/oauth2callback
   REFRESH_TOKEN=your_refresh_token
   ```

3. まだリフレッシュトークンをお持ちでない場合は、サーバーが提供する認証ツールを使って取得できます。

## 使い方

### サーバーの起動

```bash
npm run dev
```

### MCP Inspector での使用

MCP Inspector でサーバーをテストするには、次のコマンドを実行します。

```bash
npm run inspect
```

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

### 認証

リフレッシュトークンをお持ちでない場合は、次のツールを使用します。

1. `generate_auth_url` ツールを使って認証 URL を取得します
2. ブラウザーで URL を開き、アプリケーションを認証します
3. リダイレクト URL から認証コードをコピーします
4. コードを指定して `exchange_code_for_tokens` ツールを使い、リフレッシュトークンを取得します
5. リフレッシュトークンを `.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 Doc の内容を取得します
- `docs_create_document`：新しい Google Doc を作成します
- `docs_append_text`：Google Doc にテキストを追加します

### Sheets

- `sheets_get_values`：Google Sheet から値を取得します
- `sheets_update_values`：Google Sheet の値を更新します
- `sheets_create_spreadsheet`：新しい Google Sheet を作成します

### Slides

- `slides_create_presentation`：新しい Google Slides プレゼンテーションを作成します
- `slides_get_presentation`：Google Slides プレゼンテーションに関する情報を取得します
- `slides_create_slide`：プレゼンテーションに新しいスライドを作成します

### Calendar

- `calendar_list_events`：Google Calendar のイベントを一覧表示します
- `calendar_create_event`：Google Calendar に新しいイベントを作成します

### 認証

- `generate_auth_url`：OAuth2 認証 URL を生成します
- `exchange_code_for_tokens`：認証コードを OAuth2 トークンと交換します

## 利用可能なリソース
- `gmail://message/{messageId}`: 特定の Gmail メッセージを取得します
- `gmail://thread/{threadId}`: すべてのメッセージを含む Gmail スレッドを取得します
- `gmail://labels`: すべての Gmail ラベルを一覧表示します
- `workspace://docs/{service}`: 特定の Google Workspace API のドキュメント
- `workspace://auth/guide`: Google Workspace API の認証ガイド

## ライセンス

MIT