DS

dudegladiator/spreadsheet-mcp

Developer tools

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

19 stars 7 forks Качество 71 Тренд 22MIT

MCP Server для Google Sheets - читать, писать, форматировать ячейки, создавать диаграммы и многое другое

Обзор

Сервер Model Context Protocol (MCP), обеспечивающий полную функциональность Google Sheets. Чтение, запись, форматирование ячеек, создание диаграмм, использование формул и управление электронными таблицами непосредственно от Claude, Cursor или любого MCP-совместимого клиента. Я создал этот MCP-сервер для своих заданий в колледже, где я часто работаю с данными в Google Sheets. Такие задачи, как создание диаграмм, написание формул, форматирование таблиц и организация данных, были повторяющимися и трудоемкими. С помощью этого инструмента я могу автоматизировать все это и сосредоточиться на том, что действительно имеет значение — логическое мышление и анализ — вместо того, чтобы выполнять одну и ту же ручную работу снова и снова. 1. : Перейти в Google Cloud Console → Новый проект 2. : - Включить листы API - Включить Drive API 3. : - Перейти в API и сервисы → Удостоверения → Создать учетные данные → Учетная запись службы - Загрузить ключ JSON → Сохранить как учетные данные / служебный счет.json 4.

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

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

Зачем я это построил

Я создал этот MCP-сервер для своих заданий в колледже, где я часто работаю с данными в Google Sheets. Такие задачи, как создание диаграмм, написание формул, форматирование таблиц и организация данных, были повторяющимися и трудоемкими. С помощью этого инструмента я могу автоматизировать все это и сосредоточиться на том, что действительно имеет значение — логическое мышление и анализ — вместо того, чтобы выполнять одну и ту же ручную работу снова и снова.

Особенности

| Категория | Возможности

| Cell Operations | Читать, записывать, пакетные операции, добавлять строки, чистые ячейки | Полная поддержка =SUM(), =VLOOKUP(), =IF() и т. д.] | Управление листами | Создание, удаление, переименование, дублирование листов | | Формирование | Смелый курсив, цвета, выравнивание, ширина колонки, слияние ячеек | Карты | Бар, Линия, Пирог, Колонка, Площадь, Графики Скаттера | | Операции данных | Сортировать, находить/заменять, получать последний ряд |

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

README

Показан фрагмент оригинального README. Открыть оригинал.

Google Sheets MCP Server

A Model Context Protocol (MCP) server providing full Google Sheets functionality. Read, write, format cells, create charts, use formulas, and manage spreadsheets directly from Claude, Cursor, or any MCP-compatible client.

Why I Built This

I created this MCP server for my college assignments, where I frequently work with data in Google Sheets — mostly financial sheets. Tasks like creating charts, writing formulas, formatting tables, and organizing data were repetitive and time-consuming. With this tool, I can automate all of that and focus on what actually matters — logical thinking and analysis — instead of doing the same manual work over and over again. :)

Features

Category Capabilities
Cell Operations Read, write, batch operations, append rows, clear cells
Formulas Full support (=SUM(), =VLOOKUP(), =IF(), etc.)
Sheet Management Create, delete, rename, duplicate sheets
Formatting Bold, italic, colors, alignment, column widths, merge cells
Charts Bar, Line, Pie, Column, Area, Scatter charts
Data Operations Sort, find/replace, get last row
Sharing Share with users or make public

Quick Start

1. Install

cd /path/to/spreadsheet-mcp
uv sync

2. Google Cloud Setup (Free, One-Time)

  1. Create Project: Go to Google Cloud Console → New Project
  2. Enable APIs:
  3. Create Service Account:
    • Go to APIs & Services → Credentials → Create Credentials → Service Account
    • Download JSON key → Save as credentials/service-account.json
  4. Share Spreadsheets: Share your sheets with the service account email (found in JSON)

3. Run

uv run spreadsheet-mcp

MCP Client Configuration

Claude Desktop

Add to your Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "google-sheets": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/spreadsheet-mcp",
        "run",
        "spreadsheet-mcp"
      ]
    }
  }
}

Claude Code (CLI)

Add to your project’s .mcp.json file:

{
  "mcpServers": {
    "google-sheets": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/spreadsheet-mcp",
        "run",
        "spreadsheet-mcp"
      ]
    }
  }
}

Cursor

Add to Cursor’s MCP settings (Settings → MCP → Add Server):

{
  "mcpServers": {
    "google-sheets": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/spreadsheet-mcp",
        "run",
        "spreadsheet-mcp"
      ]
    }
  }
Открыть полный README на GitHub

Установка

npx -y uv --directory /path/to/spreadsheet-mcp run spreadsheet-mcp
Новичок в MCP? Начните с руководства на mcpskill.org →

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

{ "mcpServers": { "google-sheets": { "command": "uv", "args": [ "--directory", "/path/to/spreadsheet-mcp", "run", "spreadsheet-mcp" ] } } }