MCP Google Workspace サーバー

AI エージェントが Google Workspace（ドライブ、ドキュメント、スプレッドシート）サービスと対話できるようにするモデルコンテキストプロトコル（MCP）サーバー。

🌟 特徴

Google ドライブ: ファイルの検索、フォルダの作成
Google ドキュメント: ドキュメントの作成、閲覧、更新
Google スプレッドシート: スプレッドシートを作成し、セルの値を読み書きする
複数のトランスポートモード: stdio (デフォルト)、SSE、WebSocket
MCP対応クライアントサポート（カーソル等）

📋 インストール

uvの使用（推奨）

uvx mcp-google-suite

pipの使用

pip install mcp-google-suite

開発セットアップ

# Clone and install
git clone git@github.com:adexltd/mcp-google-suite.git && cd mcp-google-suite
uv venv && source .venv/bin/activate  # or .venv\Scripts\activate on Windows
uv pip install -e .

🔧 構成

MCPクライアント用の構成

クライアント設定に追加します (例: Cursor、Claude):

uvx の使用 (推奨):

{
  "mcpServers": {
    "mcp-google-suite": {
      "command": "uvx",
      "args": ["mcp-google-suite"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "~/.google/server-creds.json",
        "GOOGLE_OAUTH_CREDENTIALS": "~/.google/oauth.keys.json"
      }
    }
  }
}

pip インストールを使用する:

{
  "mcpServers": {
    "mcp-google-suite": {
      "command": "python",
      "args": ["-m", "mcp_google_suite"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "~/.google/server-creds.json",
        "GOOGLE_OAUTH_CREDENTIALS": "~/.google/oauth.keys.json"
      }
    }
  }
}

Google OAuth 設定

Google Cloud Consoleにアクセス
ドライブ、ドキュメント、スプレッドシートの API を有効にする
OAuth 2.0認証情報を作成する
~/.google/oauth.keys.jsonとして保存します。
認証するにはmcp-google authを実行します

利用可能なツール

ドライブ操作

drive_search_files : Google ドライブ内のファイルを検索する
- query (文字列、必須): 検索クエリ
- page_size (整数、オプション): 返される結果の数
drive_create_folder : 新しいフォルダを作成する
- name (文字列、必須): フォルダ名
- parent_id (文字列、オプション): 親フォルダID

ドキュメント操作

docs_create : 新しいドキュメントを作成する
- title (文字列、必須): ドキュメントのタイトル
- content （文字列、オプション）: 初期コンテンツ
docs_get_content : ドキュメントの内容を取得する
- document_id (文字列、必須): ドキュメントID
docs_update_content : ドキュメントコンテンツを更新する
- document_id (文字列、必須): ドキュメントID
- content （文字列、必須）: 新しいコンテンツ

シート操作

sheets_create : 新しいスプレッドシートを作成する
- title (文字列、必須): スプレッドシートのタイトル
- sheets （配列、オプション）: シート名
sheets_get_values : セルの値を取得する
- spreadsheet_id (文字列、必須): スプレッドシートID
- range （文字列、必須）: A1表記の範囲
sheets_update_values : セルの値を更新する
- spreadsheet_id (文字列、必須): スプレッドシートID
- range （文字列、必須）: A1表記の範囲
- values （配列、必須）: 値の2次元配列

🛠️ 開発

# Install dev dependencies
uv pip install -e ".[dev]"

# Setup pre-commit hooks
pre-commit install

# Run tests
pytest

# Format code
black . && ruff check --fix .

🔍 デバッグ

対話型テストには MCP Inspector を使用します。

# Using uvx
npx @modelcontextprotocol/inspector uvx mcp-google

# For development
cd path/to/mcp-google-suite
npx @modelcontextprotocol/inspector uv run mcp-google

📚 リソース

🤝 貢献する

行動規範とプルリクエストの送信プロセスの詳細については、 CONTRIBUTING.md をお読みください。

🔒 セキュリティ

脆弱性の報告とベストプラクティスについては、 SECURITY.md を参照してください。

📄 ライセンス

MIT ライセンス - 詳細についてはLICENSEファイルを参照してください。

MCP Google Workspace Server

Integrations