Google Sheets MCP Server

Google Sheets MCP サーバー

Google Sheets 用の Model Context Protocol（MCP）サーバーです。Claude Desktop から Google Sheets を直接操作できます。このサーバーは、Claude Desktop を通じて Google Sheets の作成、読み取り、書き込み、管理を行うためのツールを提供します。

機能

• 新しい Google Sheets を作成
• 既存のシートのデータを読み取り、書き込み
• セルと範囲の書式設定
• シートの追加と削除
• 数式の書き込み
• シートの検索
• 利用可能なシートの一覧表示

前提条件

• 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  # On 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 として保存します

設定

1. 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"
      ]
    }
  }
}

2. 初回セットアップ：
   • 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/                  # Virtual environment
├── google_sheets.py        # Main server implementation
├── pyproject.toml         # Project configuration and dependencies
├── tests/                 # Test files
└── README.md             # This file

新機能の追加

1. GoogleSheetsMCP クラスに新しいツールメソッドを追加します
2. @mcp.tool() でデコレートします
3. 新機能の説明を README に追加します

テストの実行

pytest

トラブルシューティング

1. サーバー接続の問題

   • サーバーが実行中か確認します
   • 設定内の認証情報のパスを確認します
   • Claude Desktop のログを確認します

2. 認証の問題

   • OAuth 認証情報が有効であることを確認します
   • テストユーザーとしてメールアドレスが追加されているか確認します
   • token.json を削除して再認証してみます

3. API エラー

   • Google Sheets API が有効になっていることを確認します
   • API の割り当て量と上限を確認します
   • エラーログを確認して具体的な問題を特定します

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更をコミットします
4. ブランチにプッシュします
5. プルリクエストを作成します

ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細については LICENSE ファイルを参照してください。