Для чего этот сервер?

Этот MCP-сервер соединяет AI-ассистентов с Google Таблицами, чтобы автоматически читать, записывать и управлять данными без ручного копирования. Он решает задачу интеграции искусственного интеллекта с живыми таблицами: аналитики и разработчики могут через естественный язык добавлять строки, обновлять ячейки, искать информацию и управлять листами, ускоряя обработку данных и отчетность.

Каталог MCP
xing5/mcp-google-sheets

xing5/mcp-google-sheets

от xing5

Читает и записывает данные в Google Таблицы: обновляет ячейки, ищет по документу, создаёт листы. Поддерживает сервисные аккаунты и фильтрацию инструментов.

Github PyPi Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

mcp-google-sheets

Your AI Assistant's Gateway to Google Sheets! 📊

GitHub License GitHub Actions Workflow Status

🤔 What is this?

mcp-google-sheets is a Python-based MCP server that acts as a bridge between any MCP-compatible client (like Claude Desktop) and the Google Sheets API. It allows you to interact with your Google Spreadsheets using a defined set of tools, enabling powerful automation and data manipulation workflows driven by AI.

🚀 Quick Start (Using `uvx`)

Essentially the server runs in one line: uvx mcp-google-sheets@latest.

This command will automatically download the latest code and run it. We recommend always using @latest to ensure you have the newest version with the latest features and bug fixes.

Refer to the ID Reference Guide for more information about the IDs used below.

☁️ Prerequisite: Google Cloud Setup
- You must configure Google Cloud Platform credentials and enable the necessary APIs first. We strongly recommend using a Service Account.
- ➡️ Jump to the Detailed Google Cloud Platform Setup guide below.
🐍 Install uv
- uvx is part of uv, a fast Python package installer and resolver. Install it if you haven't already:
```
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
# Or using pip:
# pip install uv
```
  Follow instructions in the installer output to add uv to your PATH if needed.

🔑 Set Essential Environment Variables (Service Account Recommended)

You need to tell the server how to authenticate. Set these variables in your terminal:

(Linux/macOS)

# Replace with YOUR actual path and folder ID from the Google Setup step
export SERVICE_ACCOUNT_PATH="/path/to/your/service-account-key.json"
export DRIVE_FOLDER_ID="YOUR_DRIVE_FOLDER_ID"

(Windows CMD)

set SERVICE_ACCOUNT_PATH="C:\path\to\your\service-account-key.json"
set DRIVE_FOLDER_ID="YOUR_DRIVE_FOLDER_ID"

(Windows PowerShell)

$env:SERVICE_ACCOUNT_PATH = "C:\path\to\your\service-account-key.json"
$env:DRIVE_FOLDER_ID = "YOUR_DRIVE_FOLDER_ID"

➡️ See Detailed Authentication & Environment Variables for other options (OAuth, CREDENTIALS_CONFIG).

🏃 Run the Server!
- uvx will automatically download and run the latest version of mcp-google-sheets:
```
uvx mcp-google-sheets@latest
```
- The server will start and print logs indicating it's ready.
- 💡 Pro Tip: Always use @latest to ensure you get the newest version with bug fixes and features. Without @latest, uvx may use a cached older version.
🔌 Connect your MCP Client
- Configure your client (e.g., Claude Desktop) to connect to the running server.
- Depending on the client you use, you might not need step 4 because the client can launch the server for you. But it's a good practice to test run step 4 anyway to make sure things are set up properly.
- ➡️ See Usage with Claude Desktop for examples.
⚡ Optional: Enable Tool Filtering (Reduce Context Usage)
- By default, all 19 tools are enabled (~13K tokens). To reduce context usage, enable only the tools you need.
- ➡️ See Tool Filtering for details.

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

`0.6.3`основная	15.05.2026
`0.6.2`	14.05.2026
`0.6.1`	16.03.2026
`0.6.0`	06.12.2025
`0.5.2`	09.11.2025
`0.5.1`	26.08.2025
`0.5.0`	22.08.2025
`0.4.1`	18.07.2025
`0.4.0`	28.05.2025
`0.3.6`	23.05.2025
`0.3.5`	22.04.2025
`0.2.0`	22.03.2025
`0.1.3`	22.03.2025
`0.1.2`	22.03.2025
`0.1.1`	22.03.2025
`0.1.0`	22.03.2025

Выберите клиент, чтобы установить xing5/mcp-google-sheets:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "xing5-mcp-google-sheets-tlorahjyaj": {
      "command": "uvx",
      "args": [
        "mcp-google-sheets@latest",
        "--include-tools",
        "get_sheet_data,update_cells,list_spreadsheets,list_sheets"
      ],
      "env": {
        "SERVICE_ACCOUNT_PATH": "/path/to/credentials.json"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "xing5-mcp-google-sheets-tlorahjyaj": {
      "command": "uvx",
      "args": [
        "mcp-google-sheets@latest",
        "--include-tools",
        "get_sheet_data,update_cells,list_spreadsheets,list_sheets"
      ],
      "env": {
        "SERVICE_ACCOUNT_PATH": "/path/to/credentials.json"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "xing5-mcp-google-sheets-tlorahjyaj": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-google-sheets@latest",
        "--include-tools",
        "get_sheet_data,update_cells,list_spreadsheets,list_sheets"
      ],
      "env": {
        "SERVICE_ACCOUNT_PATH": "/path/to/credentials.json"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"xing5-mcp-google-sheets-tlorahjyaj\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"mcp-google-sheets@latest\",\"--include-tools\",\"get_sheet_data,update_cells,list_spreadsheets,list_sheets\"],\"env\":{\"SERVICE_ACCOUNT_PATH\":\"/path/to/credentials.json\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "xing5-mcp-google-sheets-tlorahjyaj": {
      "command": "uvx",
      "args": [
        "mcp-google-sheets@latest",
        "--include-tools",
        "get_sheet_data,update_cells,list_spreadsheets,list_sheets"
      ],
      "env": {
        "SERVICE_ACCOUNT_PATH": "/path/to/credentials.json"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add xing5-mcp-google-sheets-tlorahjyaj --env SERVICE_ACCOUNT_PATH=/path/to/credentials.json -- uvx mcp-google-sheets@latest --include-tools get_sheet_data,update_cells,list_spreadsheets,list_sheets

Либо через JSON-конфиг:

claude mcp add-json xing5-mcp-google-sheets-tlorahjyaj "{\"command\":\"uvx\",\"args\":[\"mcp-google-sheets@latest\",\"--include-tools\",\"get_sheet_data,update_cells,list_spreadsheets,list_sheets\"],\"env\":{\"SERVICE_ACCOUNT_PATH\":\"/path/to/credentials.json\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add xing5-mcp-google-sheets-tlorahjyaj --env SERVICE_ACCOUNT_PATH=/path/to/credentials.json -- uvx mcp-google-sheets@latest --include-tools get_sheet_data,update_cells,list_spreadsheets,list_sheets

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.xing5-mcp-google-sheets-tlorahjyaj]
command = "uvx"
args = ["mcp-google-sheets@latest", "--include-tools", "get_sheet_data,update_cells,list_spreadsheets,list_sheets"]

[mcp_servers.xing5-mcp-google-sheets-tlorahjyaj.env]
SERVICE_ACCOUNT_PATH = "/path/to/credentials.json"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите xing5/mcp-google-sheets, а в поле команды запуска — строку ниже:

uvx mcp-google-sheets@latest --include-tools get_sheet_data,update_cells,list_spreadsheets,list_sheets

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "xing5-mcp-google-sheets-tlorahjyaj": {
      "command": "uvx",
      "args": [
        "mcp-google-sheets@latest",
        "--include-tools",
        "get_sheet_data,update_cells,list_spreadsheets,list_sheets"
      ],
      "env": {
        "SERVICE_ACCOUNT_PATH": "/path/to/credentials.json"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "xing5-mcp-google-sheets-tlorahjyaj": {
      "command": "uvx",
      "args": [
        "mcp-google-sheets@latest",
        "--include-tools",
        "get_sheet_data,update_cells,list_spreadsheets,list_sheets"
      ],
      "env": {
        "SERVICE_ACCOUNT_PATH": "/path/to/credentials.json"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например xing5-mcp-google-sheets-tlorahjyaj.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: xing5-mcp-google-sheets-tlorahjyaj
    command: uvx
    args:
      - "mcp-google-sheets@latest"
      - "--include-tools"
      - "get_sheet_data,update_cells,list_spreadsheets,list_sheets"
    env:
      SERVICE_ACCOUNT_PATH: /path/to/credentials.json

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "xing5-mcp-google-sheets-tlorahjyaj": {
      "command": "uvx",
      "args": [
        "mcp-google-sheets@latest",
        "--include-tools",
        "get_sheet_data,update_cells,list_spreadsheets,list_sheets"
      ],
      "env": {
        "SERVICE_ACCOUNT_PATH": "/path/to/credentials.json"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "uvx",
  "args": [
    "mcp-google-sheets@latest",
    "--include-tools",
    "get_sheet_data,update_cells,list_spreadsheets,list_sheets"
  ],
  "env": {
    "SERVICE_ACCOUNT_PATH": "/path/to/credentials.json"
  }
}

Нужен uvx

Сервер запускается через uvx
Без него ничего работать не будет.

Как установить uvx