MCP Google Workspace Integration

MCP Google Workspace 統合

Google Docs、Sheets、Slides、Drive などの Google Workspace サービスと連携するための、包括的な MCP（Metoro Control Protocol）ツールです。

機能

Google Drive の機能

• ファイルの一覧表示
• ファイルのコピー
• ファイル名の変更
• 空のスプレッドシートの作成
• テンプレートからスプレッドシートを作成
• 既存のスプレッドシートのコピー

Google Sheets の機能

• シートの一覧表示
• シートのコピー
• シート名の変更
• シートデータの取得
• 行の追加／削除
• 列の追加／削除
• セルの更新
• グラフの作成／更新／削除
• セルの書式設定の更新

Google Docs の機能

• ドキュメントの作成
• 書式を設定したテキストの挿入
• 見出しの追加
• 画像の挿入
• 表の作成と管理
• 改ページの挿入
• 水平線の追加
• ドキュメントのスタイルの更新
• 表のスタイルと内容の管理

Google Slides の機能

• プレゼンテーションの作成
• スライドの追加
• 画像の挿入
• 図形と線の追加
• テキストスタイルの更新
• スライドの背景の変更
• スライドレイアウトの更新
• スライドの切り替え効果の追加
• 発表者のメモの追加

インストール

1. 仮想環境のセットアップ

macOS/Linux

# Create virtual environment
python -m venv venv

# Activate virtual environment
source venv/bin/activate

Windows

# Create virtual environment
python -m venv venv

# Activate virtual environment
venv\Scripts\activate

2. 必要なパッケージのインストール

pip install -r requirements.txt

3. Google Cloud Console のセットアップ

1. Google Cloud Console でプロジェクトを作成します
2. OAuth 2.0 クライアント ID を作成します
3. 必要な API を有効にします：
   • Google Sheets API
   • Google Drive API
   • Google Docs API
   • Google Slides API

4. 環境変数のセットアップ

export MCPGD_CLIENT_SECRET_PATH="/path/to/client_secret.json"
export MCPGD_FOLDER_ID="your_folder_id"
export MCPGD_TOKEN_PATH="/path/to/token.json"  # Optional

使用方法

1. プログラムの実行

python main.py

2. MCP 経由でツールを使用する

Google Drive の例

# List files
mcp list_files

# Copy a file
mcp copy_file --file-id "file_id" --new_name "new_name"

Google Sheets の例

# Get sheet data
mcp get_sheet_data --spreadsheet_id "your_spreadsheet_id" --range "Sheet1!A1:D10"

# Create chart
mcp create_chart --chart_type "LINE" --range "A1:B10" --sheet_name "Sheet1" --title "Sales Trend"

Google Docs の例

# Create document
mcp create_document --title "My Document"

# Insert formatted text
mcp insert_text_to_document --document_id "doc_id" --text "Hello World" --font_family "Arial" --font_size 12

Google Slides の例

# Create presentation
mcp create_presentation --title "My Presentation"

# Add slide with content
mcp add_slide_to_presentation --presentation_id "presentation_id" --title "Slide Title" --content "Slide Content"

環境変数

• MCPGD_CLIENT_SECRET_PATH：Google OAuth 2.0 クライアントシークレットファイルのパス
• MCPGD_FOLDER_ID：Google Drive のフォルダー ID
• MCPGD_TOKEN_PATH：トークン保存ファイルのパス（任意、デフォルト：~/.mcp_google_spreadsheet.json）

ライセンス

MIT ライセンス