ringo380/claude-google-sheets-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

19 stars 9 forks 质量 60 趋势 22MIT

Repository Install

Google Sheets 与 Claude CLI 集成的综合模式背景协议服务器

概览

与克洛德整合Google Sheets的综合模型背景协议(MCP)服务器. 这个服务器提供对Google Sheets操作的直观访问,包括电子表格发现,数据操作,以及格式化——专门为克洛德CLI所优化. - 在您的 Google 驱动器中 - 有过滤器( 名称、所有者、日期、共享状态) - 关于任何电子表格 - 有部分匹配 - 从有多种格式选项的任何范围到有类型推论的特定范围 -- -- 安全地不覆盖现有数据 -- -- 有确认保障 - 在分钟内完成克洛德CLI集成 - - - 不需要手动JSON编辑 - /列表表,/已读表,/已写表等 - 任何谷歌账户类型的工作 - - 自动查找和配置 Claude CLI - 个人、 GCP、 Google 工作空间/ GSite - 用于引导认证配置 - OAuth 2.0、服务账户、应用程序默认证书 - 和安全缓存 - 和权限检查 - Python 3号.

概述（AI 翻译）

与克洛德整合Google Sheets的综合模型背景协议(MCP)服务器. 这个服务器提供对Google Sheets操作的直观访问,包括电子表格发现,数据操作,以及格式化——专门为克洛德CLI所优化.

安装全Claude CLI自动化的一号指令! **

□ * * * * 特点

Spreadshet发现**

** 在您的 Google 驱动器中列出所有电子表格**
** 高级搜索** 有过滤器(名称、所有者、日期、共享状态)
** 任何电子表格的详细元数据**
** 按名称查找工作表**,部分匹配

数据操作**

** 从多个格式选项的任意区域读取数据**
** 将数据** 写入特定范围,并附有类型推论
** 在不覆盖现有数据的情况下安全地附录**
** 具有确认保障的距离**

完全自动设置**

** 一个指令安装** - 几分钟内完成Claude CLI集成
自动配置 - 不需要手动JSON编辑
8个斜线命令包括 – – [[T0]、[[T1]、[[T2]等。
** 通用认证** - 任何谷歌账户类型的工程

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

Claude Google Sheets MCP Server

A comprehensive Model Context Protocol (MCP) server for Google Sheets integration with Claude. This server provides intuitive access to Google Sheets operations, including spreadsheet discovery, data manipulation, and formatting - specifically optimized for Claude CLI.

🚀 One-command installation with full Claude CLI automation!

✨ Features

🔍 Spreadsheet Discovery

List all spreadsheets in your Google Drive
Advanced search with filters (name, owner, date, sharing status)
Detailed metadata about any spreadsheet
Find sheets by name with partial matching

📊 Data Operations

Read data from any range with multiple format options
Write data to specific ranges with type inference
Append rows safely without overwriting existing data
Clear ranges with confirmation safeguards

🚀 Fully Automated Setup

One-command installation - Complete Claude CLI integration in minutes
Automatic configuration - No manual JSON editing required
8 slash commands included - /list-sheets, /read-sheet, /write-sheet, etc.
Universal authentication - Works with any Google account type
Smart detection - Automatically finds and configures Claude CLI

🔐 Universal Authentication

Works with any Google account type: Personal, GCP, Google Workspace/GSuite
Interactive setup wizard for guided authentication configuration
Multiple auth methods: OAuth 2.0, Service Account, Application Default Credentials
Automatic token refresh and secure caching
Smart account detection and permission checking

🚀 Quick Start

Prerequisites

Python 3.11 or higher
Claude CLI installed
A Google account (personal, GCP, or Google Workspace/GSuite)

Installation

🔥 One-Command Setup (Recommended)

For completely automated installation including Claude CLI configuration, slash commands, and authentication setup:

git clone https://github.com/ryanrobson/claude-google-sheets-mcp.git
cd claude-google-sheets-mcp
./install-claude-cli.sh

This script will:

✅ Install all dependencies
⚙️ Automatically configure Claude CLI
📝 Install all 8 slash commands
🔐 Guide you through authentication setup
🧪 Test the installation

Manual Installation

If you prefer step-by-step control:

Clone the repository:

git clone https://github.com/ryanrobson/claude-google-sheets-mcp.git
cd claude-google-sheets-mcp

Install the server:
```
./install.sh
```
Run the interactive setup wizard:

在 GitHub 查看完整 README

安装

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

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

{
     "mcpServers": {
       "google-sheets": {
         "command": "/path/to/claude-google-sheets-mcp/venv/bin/python",
         "args": [
           "-m",
           "claude_google_sheets.server"
         ]
       }
     }
   }