hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Enables creation, reading, and updating of Google Docs with tools to manage document content
Provides file search capabilities and folder creation within Google Drive
Allows creation of spreadsheets and managing cell values through range-based operations

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ファイルを参照してください。

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Google Workspace とのシームレスな統合を提供し、安全な OAuth2 認証を通じて Google ドライブ、ドキュメント、スプレッドシートの操作を可能にするモデルコンテキストプロトコルサーバー。

MCP Google Suite