MG

mkummer225/google-sheets-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

138 stars 40 forks Качество 60 Тренд 16MIT

mkummer225/google-sheets-mcp — это кандидат на сервер MCP, импортированный из https://github.com/mkummer225/google-sheets-mcp.

Обзор

mkummer225/google-sheets-mcp — это кандидат на сервер MCP, импортированный из https://github.com/mkummer225/google-sheets-mcp.

Обзор (машинный перевод)

Соединитель Model Context Protocol (MCP) для Google Sheets, позволяющий агентам ИИ напрямую взаимодействовать с электронными таблицами.

Демо

https://github.com/user-attachments/assets/cc4729d9-4e6e-437b-848b-6da9a09418c3

Подготовка

  1. Клонируйте этот репозиторий:

  2. Установка зависимостей: npm install

  3. Сборка: npm run build

  4. Создайте учетные данные OAuth в Google Cloud Platform:

  • Создать новый проект в Google Cloud Console
  • Включить API Google Sheets
  • Настройка экрана согласия OAuth
  • Создать учетные данные OAuth client ID (десктопное приложение) с соответствующим URI перенаправления (например: http://localhost:3000/oauth2callback)
  • Скачать учетные данные и сохранить как gcp-oauth.keys.json в подкаталоге dist
  1. Запустите MCP-сервер (при необходимости вас автоматически попросят аутентифицировать/повторить ваш аккаунт Google): npm run start

Использование

Пример конфигурации:

Тогда вы сможете просто указать свой электронный табличный ID или попросить агента создать для вас новый.

Доступные действия

Действие Описание
refresh_auth Повторная аутентификация вашего аккаунта Google после истечения срока действия учетных данных

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Google Sheets MCP

A Model Context Protocol (MCP) connector for Google Sheets that allows AI agents to interact with spreadsheets directly.

Demo

https://github.com/user-attachments/assets/cc4729d9-4e6e-437b-848b-6da9a09418c3

Setup

  1. Clone this repository:
git clone https://github.com/mkummer225/google-sheets-mcp
cd google-sheets-mcp
  1. Install dependencies: npm install

  2. Build: npm run build

  3. Create OAuth credentials in Google Cloud Platform:

  4. Start the MCP server (you’ll automatically be prompted to authenticate/re-authenticate your Google account when necessary): npm run start

Usage

Sample config:

{
    "mcpServers": {
    "google-sheets-mcp": {
      "command": "node",
      "args": [
        "/{path_to_dir}/google-sheets-mcp/dist/index.js"
      ]
    }
  }
}

Then you should be able to simply specify your spreadsheetId or ask your agent to create a new one for you.

Available Actions

Action Description
refresh_auth Re-authenticate your Google Account when credentials expire
list_sheets List all sheets/tabs in a Google Spreadsheet
create_sheet Create a new sheet/tab in a Google Spreadsheet
create_spreadsheet Create a new Google Spreadsheet
read_all_from_sheet Read all data from a specified sheet
read_headings Read the column headings from a sheet
read_rows Read specific rows from a sheet
read_columns Read specific columns from a sheet
edit_cell Edit a single cell in a sheet
edit_row Edit an entire row in a sheet
edit_column Edit an entire column in a sheet
insert_row Insert a new row at specified position
insert_column Insert a new column at specified position
rename_sheet Rename a sheet/tab in a spreadsheet
rename_doc Rename a Google Spreadsheet

License

MIT

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "google-sheets-mcp": { "command": "node", "args": [ "/{path_to_dir}/google-sheets-mcp/dist/index.js" ] } } }