MCP Google Sheets

🚀 Google SheetsとClaudeを統合する方法：完全ガイド

このガイドでは、Google SheetsとClaudeを統合する方法を詳しく説明します。この統合により、Google SheetsのデータをClaudeで利用できるようになり、業務効率を向上させることができます。

🚀 クイックスタート

準備作業

統合を開始する前に、以下のツールがインストールされていることを確認してください。

• Python 3.6以上
• pip
• グーグルChromeまたはその他の最新ブラウザ

✨ 主な機能

この統合により、以下の機能が利用できます。

• Google SheetsのデータをClaudeで読み取る
• ClaudeからGoogle Sheetsに新しいデータを書き込む
• Google SheetsのデータをClaudeで操作する

📦 インストール

ステップ1：認証の設定

方法1：サービスアカウントを使用する（推奨）

1. サービスアカウントを作成する
   • Google Cloud Consoleにログインします。
   • プロジェクト設定 > ユーザー > メンバーを追加に移動します。
   • 「サービスアカウント」を選択し、必要な権限（「Compute Engine管理者」や「Storage管理者」など）を付与します。
2. JSONキーファイルをダウンロードする
   • 完了したら、プロジェクト名をクリックしてプロジェクト概要ページに移動します。
   • 左側のメニューで「APIs & Services」>「認証情報」を選択します。
   • 「認証情報を作成」をクリックし、「サービスアカウントキー」を選択します。
   • 生成されたJSONファイル（通常はservice-account-key.jsonと命名されます）をダウンロードします。
3. 環境変数を設定する

export SERVICE_ACCOUNT_PATH="/path/to/service-account-key.json"
export DRIVE_FOLDER_ID="your-shared-folder-id"

方法2：OAuth 2.0を使用する

1. OAuth 2.0クライアントIDを作成する
   • Google Cloud Consoleで、「APIs & Services」>「認証情報」に移動します。
   • 「認証情報を作成」をクリックし、「OAuthクライアントID」を選択します。
   • リダイレクトURI（例：http://localhost:8000/callback）を設定します。
2. ユーザーの同意を取得する
   • スクリプトを実行すると、ブラウザが自動的に承認ページを開きます。
   • ユーザーはGoogleアカウントにログインし、権限を許可する必要があります。
3. 環境変数を設定する

export CREDENTIALS_PATH="/path/to/credentials.json"
export TOKEN_PATH="/path/to/token.json"

方法3：CREDENTIALS_CONFIG（Base64エンコード）を使用する

1. JSONキーファイルをBase64文字列に変換する
   • base64コマンドやオンラインコンバーターなどのツールを使用します。
   • 例：

echo '{"type":"service_account","project_id":"your-project-id","private_key_id":"key-id","private_key":"your-private-key","client_email":"service-account@your-project.iam.gserviceaccount.com","token_uri":"https://accounts.google.com/o/oauth2/token","auth_provider_x509_cert_url":"https://www.googleapis.com/robot/v1/metadata/x509/certs"}' | base64 -w 0 > credentials_base64.txt

2. 環境変数を設定する

export CREDENTIALS_CONFIG="Base64-encoded-string"
export DRIVE_FOLDER_ID="your-shared-folder-id"

ステップ2：依存関係をインストールする

pip install google-api-python-client fastmcp

💻 使用例

基本的な使用法

電子スプレッドシートの内容を読み取る

from fastmcp import FastMCP
from googleapiclient.discovery import build

# FastMCPクライアントを初期化する
client = FastMCP(
    auth_method="service_account",
    service_account_key_path="/path/to/service-account-key.json"
)

# Sheets APIサービスを作成する
sheets_service = build('sheets', 'v4', credentials=client.credentials)

# 電子スプレッドシートのデータを取得する
spreadsheet_id = "your-spreadsheet-id"
result = sheets_service.spreadsheets().values().get(
    spreadsheetId=spreadsheet_id,
    range="A1:B2"
).execute()

print(result)

新しいワークシートを作成する

from fastmcp import FastMCP
from googleapiclient.discovery import build

# FastMCPクライアントを初期化する
client = FastMCP(
    auth_method="service_account",
    service_account_key_path="/path/to/service-account-key.json"
)

# Sheets APIサービスを作成する
sheets_service = build('sheets', 'v4', credentials=client.credentials)

# 新しいワークシートのリクエストボディ
new_sheet_request = {
    "addSheet": {
        "properties": {
            "title": "New Sheet",
            "sheetType": "GRID"
        }
    }
}

# API呼び出しを実行する
result = sheets_service.spreadsheets().batchUpdate(
    spreadsheetId="your-spreadsheet-id",
    body={"requests": [new_sheet_request]}
).execute()

print("新しいワークシートが作成されました")

高度な使用法

Claudeでの統合設定

{
  "configurations": {
    "google_sheets": {
      "auth_method": "service_account",
      "service_account_key_path": "/path/to/service-account-key.json",
      "spreadsheet_id": "your-spreadsheet-id",
      "drive_folder_id": "your-shared-folder-id"
    }
  },
  "enabled_providers": ["google_sheets"]
}

使用方法

1. サービスを起動する

python your_script.py

2. リクエストを送信する 例：

{
  "provider": "google_sheets",
  "operation": "read_range",
  "params": {
    "spreadsheet_id": "your-spreadsheet-id",
    "range": "A1:A10"
  }
}

3. レスポンスを処理する サービスはJSON形式の結果を返します。

{
  "status": "success",
  "data": {
    "values": [
      ["Header"],
      ["Row 1 Data"],
      ...
    ]
  }
}

🔧 技術詳細

エラーハンドリング

コードに適切な例外ハンドリングを追加して、API呼び出しエラーをキャッチして再試行することを確認してください。

ロギング

デバッグやサービスの状態監視を容易にするために、ロギング機能を有効にすることをお勧めします。

セキュリティに関する注意事項

• キーファイルをバージョン管理システムに直接コミットしないでください。
• 定期的にサービスアカウントキーを更新してください。
• 本番環境では環境変数を使用して機密情報を管理してください。

以上の手順に従うことで、Google SheetsとClaudeを成功fullyに統合し、必要に応じて拡張およびカスタマイズすることができます。