Google Sheets MCP Server

🚀 Google Sheets MCP サーバー

Claude Desktop が Google Sheets と直接やり取りできるようにする、Google Sheets 用のモデルコンテキストプロトコル (MCP) サーバーです。このサーバーは、Google Sheets の作成、読み取り、書き込み、管理を行うためのツールを提供します。

✨ 主な機能

• 新しい Google スプレッドシートを作成する
• 既存のスプレッドシートにデータを読み書きする
• セルと範囲を書式設定する
• スプレッドシートを追加および削除する
• 数式を書き込む
• スプレッドシートを検索する
• 利用可能なスプレッドシートを一覧表示する

📦 インストール

前提条件

• Python 3.10 以上
• Google Sheets API を有効にした Google Cloud プロジェクト
• Google Cloud Console からの OAuth 2.0 認証情報
• Claude Desktop アプリケーション
• uv パッケージマネージャー（推奨）

手順

1. リポジトリをクローンします：

git clone https://github.com/yourusername/google-sheets-mcp-server.git
cd google-sheets-mcp-server

2. 仮想環境を作成してアクティブ化します：

python -m venv .venv
source .venv/bin/activate  # Windows の場合は：.venv\Scripts\activate

3. uv を使用して依存関係をインストールします：

uv pip install -e .

4. Google Cloud の認証情報を設定します：
   • Google Cloud Console にアクセスします。
   • 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
   • Google Sheets API と Google Drive API を有効にします。
   • OAuth 2.0 認証情報（デスクトップアプリ）を作成します。
   • 認証情報をダウンロードし、~/.config/google_sheets_mcp/google-sheets-mcp.json として保存します。

📚 ドキュメント

設定

Claude Desktop の設定

• Claude Desktop の設定を開きます。
• claude_desktop_config.json に以下の内容を追加します：

{
  "mcpServers": {
    "google_sheets": {
      "command": "/path/to/your/.venv/bin/python",
      "args": [
        "/path/to/your/google_sheets.py",
        "--credentials-path",
        "/Users/yourusername/.config/google_sheets_mcp/google-sheets-mcp.json",
        "--log-level",
        "DEBUG"
      ]
    }
  }
}

初回設定

• サーバーを手動で実行して、OAuth 認証を完了させます：

python google_sheets.py --credentials-path ~/.config/google_sheets_mcp/google-sheets-mcp.json

• ブラウザの指示に従って、アプリケーションを承認します。
• トークンは自動的に保存され、将来の使用に備えられます。

使用方法

設定が完了したら、Claude Desktop で以下のコマンドを使用できます：

• 新しいスプレッドシートを作成する：create_sheet(title: str)
• セルを書式設定する：format_range(file_id: str, range: str, format: dict)
• 数式を書き込む：write_formula(file_id: str, range: str, formula: str)
• スプレッドシートを追加する：add_sheet(file_id: str, title: str)
• スプレッドシートを削除する：delete_sheet(file_id: str, sheet_id: int)
• スプレッドシートのプロパティを取得する：get_sheet_properties(file_id: str)

開発

プロジェクト構造

google-sheets-mcp-server/
├── .venv/                  # 仮想環境
├── google_sheets.py        # メインサーバーの実装
├── pyproject.toml         # プロジェクトの設定と依存関係
├── tests/                 # テストファイル
└── README.md             # このファイル

新機能の追加

1. GoogleSheetsMCP クラスに新しいツールメソッドを追加します。
2. @mcp.tool() デコレータでそれらを装飾します。
3. README の新機能ドキュメントを更新します。

テストの実行

pytest

トラブルシューティング

サーバー接続の問題

• サーバーが実行中かどうかを確認します。
• 認証情報のパスが正しいかを検証します。
• Claude Desktop のログを確認します。

認証の問題

• OAuth 2.0 認証情報が有効であることを確認します。
• アプリケーションが適切な権限を持っていることを確認します。
• 最新バージョンのライブラリとツールを使用していることを確認します。

その他の問題

• 詳細なエラー情報を取得するために、コンソール出力を確認します。
• Google Sheets API が正しく有効になっていることを確認します。
• すべての依存関係がインストールされていることを検証します。

付録

サンプルコード

# これは、google_sheets.py ライブラリを使用して基本的な操作を行う簡単な例です。

from google_sheets import GoogleSheetsMCP

# MCP サーバーを初期化します。
mcp = GoogleSheetsMCP(credentials_path='path/to/google-sheets-mcp.json')

# 新しいスプレッドシートを作成します。
sheet_id = mcp.create_sheet('サンプルスプレッドシート')

# スプレッドシートにデータを書き込みます。
mcp.write_formula(sheet_id, 'A1', '=SUM(1,2)')

# セルの内容を読み取ります。
value = mcp.read_cell(sheet_id, 'A1')
print(value)  # 出力: 3

# スプレッドシートを削除します。
mcp.delete_sheet(sheet_id)

よくある質問

Q：OAuth 認証エラーをどのように処理すればいいですか？ A：Google Cloud プロジェクトで正しい API が有効になっていること、および認証情報ファイルのパスが正しいことを確認してください。コンソール出力を確認して、具体的なエラー情報を取得してください。

Q：Google Sheets に接続できません。どうすればいいですか？ A：インターネット接続が正常であること、Google Sheets API が有効になっていること、および使用している認証情報が適切な権限を持っていることを確認してください。

連絡先

ヘルプが必要な場合や問題を報告する場合は、プロジェクトのホームページ にアクセスするか、support@yourdomain.com までメールを送信してください。