Googlesheets MCP Server

🚀 Google Sheets API MCP サーバー

このサーバーは、Google Sheets API を用いて、電子スプレッドシートの作成、読み取り、更新、削除などの操作を行うことができます。また、MCP リソースを通じて電子スプレッドシートデータにアクセスすることも可能です。

✨ 主な機能

• 電子スプレッドシートの作成、読み取り、更新、削除
• 電子スプレッドシート内のワークシートの管理
• 値の読み取り、書き込み、追加、クリア
• 開発者メタデータの処理
• MCP リソースを通じた電子スプレッドシートデータへのアクセス

📦 インストール

前提条件

• Node.js 16 以上
• Google Cloud Platform プロジェクトで Google Sheets API を有効にする
• OAuth 2.0 認証情報（クライアント ID、クライアントシークレット、リフレッシュトークン）

手順

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

3. .env.example をもとに .env ファイルを作成し、Google API の認証情報を入力します。

   CLIENT_ID=your_client_id
   CLIENT_SECRET=your_client_secret
   REDIRECT_URI=your_redirect_uri
   REFRESH_TOKEN=your_refresh_token
   

💻 使用例

サーバーの起動

npm start

開発モード

npm run dev

MCP Inspector を使用したテスト

npm run inspect

利用可能なツール

スプレッドシート管理

• createSpreadsheet：新しいスプレッドシートを作成します。
• getSpreadsheet：スプレッドシートの詳細情報を取得します。
• batchUpdate：スプレッドシートに複数の更新を適用します。

シート管理

• copySheet：シートを別のスプレッドシートにコピーします。
• addSheet：スプレッドシートに新しいシートを追加します。
• deleteSheet：スプレッドシートからシートを削除します。
• updateSheetProperties：シートのプロパティを更新します。

値管理

• getValues：範囲から値を取得します。
• updateValues：範囲内の値を更新します。
• appendValues：範囲に値を追加します。
• clearValues：範囲内の値をクリアします。
• batchGetValues：複数の範囲から値を取得します。
• batchUpdateValues：複数の範囲内の値を更新します。

開発者メタデータ

• getDeveloperMetadata：すべての開発者メタデータを取得します。
• createDeveloperMetadata：新しい開発者メタデータを作成します。
• updateDeveloperMetadata：既存の開発者メタデータを更新します。
• deleteDeveloperMetadata：開発者メタデータを削除します。

利用可能なリソース

• sheets://spreadsheet/{spreadsheetId}：スプレッドシートの詳細情報を取得します。
• sheets://spreadsheet/{spreadsheetId}/sheet/{sheetName}：シートの詳細情報を取得します。
• sheets://spreadsheet/{spreadsheetId}/values/{range}：範囲から値を取得します。
• sheets://spreadsheet/{spreadsheetId}/metadata：すべての開発者メタデータを取得します。

📚 ドキュメント

このサーバーは OAuth 2.0 を使用して認証を行い、Google Sheets API と連携しています。.env ファイルに以下の認証情報を提供する必要があります。

• CLIENT_ID：Google API のクライアント ID
• CLIENT_SECRET：Google API のクライアントシークレット
• REDIRECT_URI：Google API プロジェクトで設定したリダイレクト URI
• REFRESH_TOKEN：OAuth 2.0 フローを通じて取得したリフレッシュトークン

📄 ライセンス

MIT