Google Sheets Mcp

Google Sheets MCP

Claude（およびその他の MCP クライアント）に、OAuth 経由で任意の Google スプレッドシートへの読み取り／書き込みアクセスを提供する Model Context Protocol（MCP） サーバーです。

ツール

ツール	説明
read_sheet	スプレッドシート内の任意の範囲からデータを読み取ります
write_sheet	スプレッドシートにデータを書き込み、または更新します
append_rows	スプレッドシートに新しい行を追加します
get_sheet_info	シート名、行数、列数を取得します
clear_range	セル範囲の内容を消去します

すべてのツールは、Google Sheets の完全な URL または スプレッドシート ID のみを受け付けます。

---

前提条件

• Node.js 18+
• Google アカウント
• Google Cloud プロジェクト（無料）

---

セットアップ

1. リポジトリをクローンする

git clone https://github.com/generalist-club/google-sheets-mcp.git
cd google-sheets-mcp
npm install

2. Google Cloud プロジェクトと OAuth 認証情報を作成する

1. Google Cloud Console にアクセスします
2. 新しいプロジェクトを作成します（または既存のものを選択します）
3. Google Sheets API と Google Drive API を有効にします：
   • APIs & Services → Library に移動します
   • 両方の API を検索して有効にします
4. OAuth 認証情報を作成します：
   • APIs & Services → Credentials に移動します
   • Create Credentials → OAuth client ID をクリックします
   • アプリケーションの種類：Desktop app
   • JSON ファイルをダウンロードします
5. ダウンロードしたファイルの名前を credentials.json に変更し、プロジェクトのルートに配置します

3. 認証する

認証スクリプトを実行してトークンを生成します：

node auth.js

URL が表示されます。ブラウザーで開いてアプリを承認し、コードをターミナルに貼り付けます。これにより、ローカルに token.json ファイルが作成されます。秘密にしておいてください。

トークンの更新： サーバーは、有効期限が切れるとアクセストークンを自動的に更新します。auth.js の実行は通常、一度だけで済みます。

4. Claude Desktop（または任意の MCP クライアント）を設定する

このサーバーを、Claude Desktop の設定ファイル ~/Library/Application Support/Claude/claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "google-sheets": {
      "command": "node",
      "args": ["/absolute/path/to/google-sheets-mcp/index.js"]
    }
  }
}

/absolute/path/to/google-sheets-mcp を、お使いのマシン上の実際のパスに置き換えます。

Claude Desktop を再起動します。これで、5 つの Google Sheets ツールが利用可能になります。

---

使用例

接続後、Claude に次のようなことを依頼できます：

• 「このスプレッドシートのデータを読み取ってください：https://docs.google.com/spreadsheets/d/...」
• 「今日の日付と 42 を含む新しい行を Sheet1 に追加してください」
• 「このワークブックにはどのシートがあり、それぞれ何行ありますか？」
• 「スプレッドシートの範囲 B2:D10 を消去してください」

---

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

• .gitignore により credentials.json と token.json は Git の対象外になっています。絶対にコミットしないでください
• OAuth トークンはローカルに保存され、自分の Google アカウントへのアクセスのみを許可します
• 要求されるスコープ：spreadsheets（読み取り／書き込み）および drive.readonly（シートのメタデータを解決するため）

---

ライセンス

MIT