MCP Google Sheets MCP Server安装配置 GitHub与使用方法

选型结论

MCP Google Sheets 属于开发工具类 MCP Server，公开资料标注 19 个工具，通过stdio 本地进程接入，适配 Claude Desktop、Claude，有可以直接复制的安装命令；接入前先确认权限范围。

分类

开发工具

传输方式

stdio

认证方式

无需认证

部署方式

支持远程部署

安装与配置

安装命令

uvx mcp-google-sheets@latest

客户端配置示例

{
  "mcpServers": {
    "mcp-google-sheets": {
      "command": "uvx",
      "args": [
        "mcp-google-sheets@latest"
      ]
    }
  }
}

按公开安装命令拼出来的示例，字段名和参数以仓库 README 为准；带 YOUR_API_KEY 这类占位符的位置记得换成自己的值。

上手步骤

1
准备运行环境
stdio 服务在本地起进程，需要先装好 Python，再按安装命令拉取依赖。
2
安装服务
复制下面的安装命令执行；命令里带占位符的位置换成自己的密钥或路径。
3
写入客户端配置
在客户端的 MCP 配置里填启动命令和参数，保存后完全退出客户端再打开，让新配置生效。
4
验证是否可用
连接成功后客户端会列出 19 个工具，随便调一个只读工具确认能返回结果。

接入前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

详细介绍

mcp-google-sheets

Your AI Assistant's Gateway to Google Sheets! 📊

______________________________________________________________________

🤔 这是什么？

mcp-google-sheets 是一个基于Python的MCP服务器，充当任何兼容MCP的客户端（如Claude Desktop）和Google Sheets API之间的桥梁。它允许您使用一组定义好的工具与Google电子表格进行交互，从而实现由AI驱动的强大自动化和数据操作工作流程。

______________________________________________________________________

🚀 快速入门（使用 `uvx`)

从本质上讲，服务器运行在一行中： uvx mcp-google-sheets@latest.

此命令将自动下载最新代码并运行它。 我们建议始终使用 @latest 以确保您拥有具有最新功能和错误修复的最新版本。

_请参阅 ID参考指南有关下面使用的ID的更多信息。_

☁️ 先决条件：谷歌云设置

- 你必须首先配置Google Cloud Platform凭据并启用必要的API。我们强烈建议使用 服务账号. - ➡️ 跳到 详细的Google云平台设置 下面的指南。

🐍 安装 uv

- uvx 是...的一部分 uv，一个快速的Python包安装程序和解析器。如果您还没有安装它：

     # 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

*按照安装程序输出中的说明添加 uv 如有需要，请前往您的路径。*

🔑 设置基本环境变量（建议使用服务帐户）

- 您需要告诉服务器如何进行身份验证。在终端中设置这些变量： - （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"

- ➡️ 看 详细的身份验证和环境变量 对于其他选项（OAuth， CREDENTIALS_CONFIG).

🏃 运行服务器！

- uvx 将自动下载并运行最新版本的 mcp-google-sheets:

     uvx mcp-google-sheets@latest

- 服务器将启动并打印日志，表明它已准备就绪。 - - > 💡 专业提示： 始终使用 @latest 以确保您获得具有错误修复和功能的最新版本。没有 @latest, uvx 可能会使用缓存的旧版本。

🔌 连接您的MCP客户端

- 配置您的客户端（例如Claude Desktop）以连接到正在运行的服务器。 - 根据您使用的客户端，您可能不需要步骤4，因为客户端可以为您启动服务器。但无论如何，测试运行步骤4以确保设置正确是一种很好的做法。 - ➡️ 看 使用Claude Desktop 例如。

⚡ 可选：启用工具筛选（减少上下文使用）

- 默认情况下，所有19个工具都已启用（约13K个令牌）。要减少上下文使用，请仅启用所需的工具。 - ➡️ 看 工具筛选 了解详情。

你准备好了！开始通过MCP客户端发出命令。

______________________________________________________________________

✨ 主要特点

无缝集成： 直接连接到Google云端硬盘和Google表格API。
综合工具： 提供广泛的操作（CRUD、列表、批处理、共享、格式化等）。
灵活的身份验证： 支持 服务帐户（推荐）OAuth 2.0，以及通过环境变量直接注入凭据。
易于部署： 立即跑步 uvx （零安装感觉）或使用克隆进行开发 uv.
AI就绪： 专为与MCP兼容的客户端一起使用而设计，支持自然语言电子表格交互。
工具筛选： 通过仅启用所需的工具来减少上下文窗口的使用 --include-tools 或 ENABLED_TOOLS 环境变量。

______________________________________________________________________

🎯 工具筛选（减少上下文使用）

问题： 默认情况下，此MCP服务器公开所有19个工具，在任何对话开始之前消耗约13000个令牌。如果你只需要几个工具，这会浪费宝贵的上下文窗口空间。

解决方案： 使用工具筛选仅启用您实际使用的工具。

如何启用工具筛选

您可以使用以下任一方式过滤工具：

命令行参数 --include-tools:

   {
     "mcpServers": {
       "google-sheets": {
         "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"
         }
       }
     }
   }

环境变量 ENABLED_TOOLS:

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

可用工具名称

筛选时，使用这些精确的工具名称（逗号分隔，无空格）：

最常用工具（推荐子集）：

get_sheet_data -从电子表格中读取
update_cells -写入电子表格
list_spreadsheets -查找电子表格
list_sheets -导航选项卡

所有可用工具：

add_columns
add_rows
batch_update
batch_update_cells
copy_sheet
create_sheet
create_spreadsheet
find_in_spreadsheet
get_multiple_sheet_data
get_multiple_spreadsheet_summary
get_sheet_data
get_sheet_formulas
list_folders
list_sheets
list_spreadsheets
rename_sheet
search_spreadsheets
share_spreadsheet
update_cells

注：如果两者都没有 --include-tools 也不 ENABLED_TOOLS 如果指定，则启用所有工具（默认行为）。

______________________________________________________________________

🛠️ 可用工具和资源

此服务器公开了以下与Google表格交互的工具：

_请参阅 ID参考指南有关下面使用的ID的更多信息。_

*（除非另有说明，否则输入参数通常为字符串）*

list_spreadsheets：列出配置的驱动器文件夹（服务帐户）中或用户可访问的电子表格（OAuth）。

- folder_id （可选字符串）：要搜索的Google Drive文件夹ID。从其URL获取。如果省略，则使用配置的默认文件夹或搜索“我的驱动器”。 - _退货：_ 对象列表 [{id: string, title: string}]

create_spreadsheet：创建新的电子表格。

- title （string）：电子表格所需的标题。示例：“第四季度季度报告”。 - folder_id （可选字符串）：创建电子表格的Google Drive文件夹ID。从其URL获取。如果省略，则使用配置的默认值或根。 - _退货：_ 包含电子表格信息的对象，包括 spreadsheetId, title，以及 folder.

get_sheet_data：从工作表/选项卡中的某个范围读取数据。

- spreadsheet_id （string）：电子表格ID（来自其URL）。 - sheet （string）：工作表/选项卡的名称（例如，“Sheet1”）。 - range （可选字符串）：A1表示法（例如。， 'A1:C10', 'Sheet1!B2:D').如果省略，则读取由指定的整个工作表/选项卡 sheet. - include_grid_data （可选布尔值，默认值 False)：如果 True，返回完整的网格数据，包括格式和元数据（大得多）。如果 False，仅返回值（更高效）。 - _退货：_ 如果 include_grid_data=True，带元数据的全网格数据(get 响应).如果 False，来自values API的值结果对象(values.get 响应).

get_sheet_formulas：从工作表/选项卡中的某个范围读取公式。

- spreadsheet_id （string）：电子表格ID（来自其URL）。 - sheet （string）：工作表/选项卡的名称（例如，“Sheet1”）。 - range （可选字符串）：A1表示法（例如。， 'A1:C10', 'Sheet1!B2:D').如果省略，则读取由指定的工作表/选项卡中的所有公式 sheet. - _退货：_ 二维单元格公式数组（数组数组）(values.get 响应).

update_cells：将数据写入特定范围。覆盖现有数据。

- spreadsheet_id （string）：电子表格ID（来自其URL）。 - sheet （string）：工作表/选项卡的名称（例如，“Sheet1”）。 - range （字符串）：要写入的A1表示法范围（例如，“A1:C3”）。 - data （数组）：要写入的二维值数组。例子： [[1, 2, 3], ["a", "b", "c"]]. - _退货：_ 更新结果对象(values.update 响应).

batch_update_cells：在一个API调用中更新多个范围。

- spreadsheet_id （string）：电子表格ID（来自其URL）。 - sheet （string）：工作表/选项卡的名称（例如，“Sheet1”）。 - ranges （object）：将范围字符串（A1表示法）映射到2D值数组的字典。例子： { "A1:B2": [[1, 2], [3, 4]], "D5": [["Hello"]] }. - _退货：_ 操作结果(values.batchUpdate 响应).

add_rows：在指定索引处向工作表/选项卡添加（插入）空行。

- spreadsheet_id （string）：电子表格ID（来自其URL）。 - sheet （string）：工作表/选项卡的名称（例如，“Sheet1”）。 - count （整数）：要插入的空行数。 - start_row （可选整数，默认值 0)：从0开始插入行的行索引。如果省略，则默认为 0 （插入开头）。 - _退货：_ 操作结果(batchUpdate 响应).

list_sheets：列出电子表格中的所有工作表/选项卡名称。

- spreadsheet_id （string）：电子表格ID（来自其URL）。 - _退货：_ 工作表/选项卡名称字符串列表。例子： ["Sheet1", "Sheet2"].

create_sheet：在电子表格中添加新的工作表/选项卡。

- spreadsheet_id （string）：电子表格ID（来自其URL）。 - title （string）：新工作表/选项卡的名称。 - _退货：_ 新建图纸属性对象。

get_multiple_sheet_data：在一次调用中从可能不同的电子表格的多个范围获取数据。

- queries （对象数组）：每个对象都需要 spreadsheet_id, sheet，以及 range示例： [{"spreadsheet_id": "abc", "sheet": "Sheet1", "range": "A1:B2"}, ...]. - _退货：_ 对象列表，每个对象都包含查询参数并已获取 data 或a error.每个 data 是一个 values.get 响应.

get_multiple_spreadsheet_summary：获取多个电子表格的标题、工作表/选项卡名称、标题和前几行。

- spreadsheet_ids （字符串数组）：电子表格的ID（来自其URL）。 - rows_to_fetch （可选整数，默认值 5)：要预览的行数（包括页眉）。例子： 5. - _退货：_ 每个电子表格的摘要对象列表。

share_spreadsheet：与指定的用户/电子邮件和角色共享电子表格。

- spreadsheet_id （string）：电子表格ID（来自其URL）。 - recipients （对象数组）： [{"email_address": "user@example.com", "role": "writer"}, ...].角色： reader, commenter, writer. - send_notification （可选布尔值，默认值 True)：向收件人发送电子邮件通知。 - _退货：_ 词典与 successes 和 failures 列表。

add_columns：在指定索引处向工作表/选项卡添加（插入）空列。

- spreadsheet_id （string）：电子表格ID（来自其URL）。 - sheet （string）：工作表/选项卡的名称（例如，“Sheet1”）。 - count （整数）：要插入的空列数。 - start_column （可选整数，默认值 0)：从0开始插入列索引。如果省略，则默认为 0 （插入开头）。 - _退货：_ 操作结果(batchUpdate 响应).

copy_sheet：将工作表/选项卡从一个电子表格复制到另一个，并可选择重命名。

- src_spreadsheet （string）：源电子表格ID（来自其URL）。 - src_sheet （string）：源工作表/选项卡名称（例如“Sheet1”）。 - dst_spreadsheet （string）：目标电子表格ID（来自其URL）。 - dst_sheet （string）：目标电子表格中所需的工作表/选项卡名称。 - _退货：_ 复制和可选重命名操作的结果。

rename_sheet：重命名现有工作表/选项卡。

- spreadsheet （string）：电子表格ID（来自其URL）。 - sheet （string）：当前工作表/选项卡名称（例如，“Sheet1”）。 - new_name （字符串）：新工作表/选项卡名称（例如“事务”）。 - _退货：_ 操作结果(batchUpdate 响应).

add_chart：根据指定数据在Google电子表格中创建图表。

- spreadsheet_id （string）：电子表格ID（来自其URL）。 - sheet （string）：包含数据的工作表/选项卡的名称（例如，“Sheet1”）。 - chart_type （string）：要创建的图表类型。选项： COLUMN （垂直条）， BAR （水平条）， LINE, AREA, PIE, SCATTER, COMBO, HISTOGRAM. - data_range （字符串）：图表数据的A1表示范围（例如，“A1:C10”）。第一行被视为标题。 - title （可选字符串）：图表标题。 - x_axis_label （可选字符串）：X轴（底部轴）的标签。不适用于饼图。 - y_axis_label （可选字符串）：Y轴（左轴）的标签。不适用于饼图。 - position_x （可选整数，默认值 0)：从左上角开始的水平位置偏移（像素）。 - position_y （可选整数，默认值 0)：从左上角开始的垂直位置偏移（像素）。 - width （可选整数，默认值 600)：图表的宽度（像素）。 - height （可选整数，默认值 400)：图表的高度（像素）。 - _退货：_ 带有成功状态、图表ID和操作详细信息的结果对象。

MCP资源：

spreadsheet://{spreadsheet_id}/info：获取有关Google电子表格的基本元数据。

- _退货：_ 包含电子表格信息的JSON字符串。

______________________________________________________________________

☁️ 谷歌云平台设置（详细）

此设置是 必需的 在运行服务器之前。

创建/选择GCP项目： 去谷歌云控制台.
启用API： 导航到“API和服务”->“库”。搜索并启用：

- Google Sheets API - Google Drive API

配置凭据： 你需要做出选择 *一* 下面的身份验证方法（建议使用服务帐户）。

______________________________________________________________________

🔑 身份验证和环境变量（详细）

服务器需要凭据才能访问Google API。选择一种方法：

_请参阅 ID参考指南有关下面使用的ID的更多信息。_

方法A：服务帐户（建议用于服务器/自动化）✅

为什么？ 无头（无需浏览器），安全，非常适合服务器环境。不容易过期。
步骤：

1. 创建服务帐户： 在GCP控制台->“IAM和管理”->“服务帐户”中。 - 点击“+创建服务帐户”。命名它（例如。， mcp-sheets-service). - 授予角色：添加 Editor 用于广泛访问的角色，或更细粒度的角色（如 roles/drive.file 以及特定的表格角色）以获得更严格的权限。 - 单击“完成”。找到帐户，单击操作（⋮）->“管理密钥”。 - 点击“添加密钥”->“创建新密钥”-> JSON ->“创造”。 - 下载并安全存储 JSON密钥文件。 1. 创建和共享Google Drive文件夹： - 在 Google 云端硬盘，创建一个文件夹（例如“AI管理表”）。 - 注意 文件夹ID 从URL： https://drive.google.com/drive/folders/THIS_IS_THE_FOLDER_ID. - 右键单击文件夹->“共享”->“分享”。 - 输入服务帐户的电子邮件（来自JSON文件 client_email). - 授予编辑访问。取消选中“通知人员”。点击“分享”。 1. 设置环境变量： - SERVICE_ACCOUNT_PATH：下载的JSON密钥文件的完整路径。 - DRIVE_FOLDER_ID：共享Google Drive文件夹的ID。 *（参见超快速启动对于特定于操作系统的示例）*

方法B:Auth2.0（交互式/个人使用）🧑‍💻

为什么？ 用于个人使用或本地开发，其中交互式浏览器登录是可以的。
步骤：

1. 配置OAuth同意屏幕： 在GCP控制台->“API和服务”->“OAuth同意屏幕”中。选择“外部”，填写所需信息，添加范围(.../auth/spreadsheets, .../auth/drive)，如果需要，添加测试用户。 1. 创建OAuth客户端ID: 在GCP控制台->“API和服务”->“凭据”中。“+创建信任”->“OAuth客户端ID”->键入： 桌面应用程序。命名它。“CREATE”。 下载JSON. 1. 设置环境变量： - CREDENTIALS_PATH：下载的OAuth凭据JSON文件的路径（默认值： credentials.json). - TOKEN_PATH：首次登录后存储用户刷新令牌的路径（默认值： token.json).必须可写。

方法C：直接凭证注入（高级）🔒

为什么？ 在Docker、Kubernetes或CI/CD等环境中很有用，在这些环境中管理文件很困难，但环境变量很容易/安全。避免文件系统访问。
怎么用？ 而不是提供 *路径* 在凭据文件中，您需要提供 *内容* 以Base64编码的文件，直接存储在环境变量中。
步骤：

1. 获取您的凭据JSON文件 （服务帐户密钥或OAuth客户端ID文件）。我们就这样说吧 your_credentials.json. 1. 生成Base64字符串： - （Linux/macOS）： base64 -w 0 your_credentials.json - （Windows PowerShell）：

       $filePath = "C:\path\to\your_credentials.json"; # Use actual path
       $bytes = [System.IO.File]::ReadAllBytes($filePath);
       $base64 = [System.Convert]::ToBase64String($bytes);
       $base64 # Copy this output

- （注意）： 避免将敏感凭据粘贴到不受信任的在线编码器中。 1. 设置环境变量： - CREDENTIALS_CONFIG：将此变量设置为 完整的Base64字符串 你刚刚生成。

       # Example (Linux/macOS) - Use the actual string generated
       export CREDENTIALS_CONFIG="ewogICJ0eXBlIjogInNlcnZpY2VfYWNjb..."

方法D：应用程序默认凭据（ADC）🌐

为什么？ 非常适合谷歌云环境（GKE、计算引擎、云运行）和本地开发 gcloud auth application-default login。不需要显式凭据文件。
怎么用？ 使用Google的应用程序默认凭据链自动发现来自多个来源的凭据。
ADC搜索顺序：

1. GOOGLE_APPLICATION_CREDENTIALS 环境变量（服务帐户密钥的路径）- Google的标准变量 1. gcloud auth application-default login 证书（当地发展） 1. 从元数据服务器（GKE、Compute Engine等）附加服务帐户

设置：

- 地方发展： 1. 跑 gcloud auth application-default login --scopes=https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spreadsheets,https://www.googleapis.com/auth/drive 一次 1. 设置配额项目： gcloud auth application-default set-quota-project （替换使用您的Google Cloud项目ID） - 谷歌云： 将服务帐户附加到您的计算资源 - 环境变量： 集 GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json （谷歌标准）

不需要额外的环境变量 -当其他方法失败时，ADC会自动用作回退。

注： GOOGLE_APPLICATION_CREDENTIALS 是谷歌的官方标准环境变量，而 SERVICE_ACCOUNT_PATH 特定于此MCP服务器。如果你设置 GOOGLE_APPLICATION_CREDENTIALS，ADC会自动找到它。

身份验证优先级和摘要

服务器按以下顺序检查凭据：

CREDENTIALS_CONFIG （Base64内容）
SERVICE_ACCOUNT_PATH （服务帐户JSON路径）
CREDENTIALS_PATH （OAuth JSON路径）-如果令牌丢失/过期，则触发交互流
应用程序默认凭据（ADC） -自动回退

环境变量摘要：

变量	方法	描述	默认值
`SERVICE_ACCOUNT_PATH`	服务帐户	服务帐户JSON密钥文件的路径（特定于MCP服务器）。	-
`GOOGLE_APPLICATION_CREDENTIALS`	ADC	服务帐户密钥的路径（谷歌的标准变量）。	-
`DRIVE_FOLDER_ID`	服务帐户	与服务帐户共享的Google Drive文件夹的ID。	-
`CREDENTIALS_PATH`	OAuth 2.0	OAuth 2.0客户端ID JSON文件的路径。	`credentials.json`
`TOKEN_PATH`	OAuth 2.0	存储生成的OAuth令牌的路径。	`token.json`
`CREDENTIALS_CONFIG`	服务帐户/Outh2.0	Base64编码的JSON凭据字符串内容。	-

______________________________________________________________________

⚙️ 运行服务器（详细）

_请参阅 ID参考指南有关下面使用的ID的更多信息。_

方法1：使用 `uvx` （推荐给用户）

如图所示超快速启动，这是最简单的方法。设置环境变量，然后运行：

uvx mcp-google-sheets@latest

uvx 处理临时获取和运行包。

方法2：用于开发（克隆Repo）

如果你想修改代码：

克隆： git clone https://github.com/yourusername/mcp-google-sheets.git && cd mcp-google-sheets （使用实际URL）
设置环境变量： 如上所述。
使用运行 uv: （使用当地代码）

   uv run mcp-google-sheets
   # Or via the script name if defined in pyproject.toml, e.g.:
   # uv run start

方法3:Docker（SSE传输）

使用附带的在容器中运行服务器 Dockerfile:

# Build the image
docker build -t mcp-google-sheets .

# Run (SSE on port 8000)
# NOTE: Prefer CREDENTIALS_CONFIG (Base64 credentials content) in containers.
docker run --rm -p 8000:8000 ^
  -e HOST=0.0.0.0 ^
  -e PORT=8000 ^
  -e CREDENTIALS_CONFIG=YOUR_BASE64_CREDENTIALS ^
  -e DRIVE_FOLDER_ID=YOUR_DRIVE_FOLDER_ID ^
  mcp-google-sheets

使用 CREDENTIALS_CONFIG 而不是 SERVICE_ACCOUNT_PATH 在Docker内部，避免将机密作为文件挂载。
容器开始于 --transport sse 并继续收听 HOST/PORT.将您的MCP客户端指向 http://localhost:8000 使用SSE传输。

______________________________________________________________________

🔌 使用Claude Desktop

将服务器配置添加到 claude_desktop_config.json 在...之下 mcpServers。选择与您的设置匹配的块：

_请参阅 ID参考指南有关下面使用的ID的更多信息。_

⚠️ 重要提示：

🍎 macOS用户： 使用完整路径： "/Users/yourusername/.local/bin/uvx" 而不是仅仅 "uvx"

🔵 Config: uvx + Service Account (Recommended)

{
  "mcpServers": {
    "google-sheets": {
      "command": "uvx",
      "args": ["mcp-google-sheets@latest"],
      "env": {
        "SERVICE_ACCOUNT_PATH": "/full/path/to/your/service-account-key.json",
        "DRIVE_FOLDER_ID": "your_shared_folder_id_here"
      }
    }
  }
}

🍎 macOS注意事项： 如果你得到一个 spawn uvx ENOENT 错误，请使用完整路径 uvx:

{
  "mcpServers": {
    "google-sheets": {
      "command": "/Users/yourusername/.local/bin/uvx",
      "args": ["mcp-google-sheets@latest"],
      "env": {
        "SERVICE_ACCOUNT_PATH": "/full/path/to/your/service-account-key.json",
        "DRIVE_FOLDER_ID": "your_shared_folder_id_here"
      }
    }
  }
}

*替换 yourusername 使用您的实际用户名。*

🔵 Config: uvx + OAuth 2.0

{
  "mcpServers": {
    "google-sheets": {
      "command": "uvx",
      "args": ["mcp-google-sheets@latest"],
      "env": {
        "CREDENTIALS_PATH": "/full/path/to/your/credentials.json",
        "TOKEN_PATH": "/full/path/to/your/token.json"
      }
    }
  }
}

*注意：首次使用时，浏览器可能会打开进行谷歌登录。确保TOKEN_PATH可写。*

🍎 macOS注意事项： 如果你得到一个 spawn uvx ENOENT 错误，替换 "command": "uvx" 随着 "command": "/Users/yourusername/.local/bin/uvx" （替换 yourusername 使用您的实际用户名）。

🔵 Config: uvx + CREDENTIALS_CONFIG (Service Account Example)

{
  "mcpServers": {
    "google-sheets": {
      "command": "uvx",
      "args": ["mcp-google-sheets@latest"],
      "env": {
        "CREDENTIALS_CONFIG": "ewogICJ0eXBlIjogInNlcnZpY2VfYWNjb3VudCIsCiAgInByb2plY3RfaWQiOiAi...",
        "DRIVE_FOLDER_ID": "your_shared_folder_id_here"
      }
    }
  }
}

*注意：粘贴CREDENTIALS_CONFIG的完整Base64字符串。服务帐户文件夹上下文仍然需要DRIVE_FOLDER_ID。*

🍎 macOS注意事项： 如果你得到一个 spawn uvx ENOENT 错误，替换 "command": "uvx" 随着 "command": "/Users/yourusername/.local/bin/uvx" （替换 yourusername 使用您的实际用户名）。

🔵 Config: uvx + Application Default Credentials (ADC)

选项1：使用GOOGLE_APPLICATION_CREDENTIALS

{
  "mcpServers": {
    "google-sheets": {
      "command": "uvx",
      "args": ["mcp-google-sheets@latest"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json"
      }
    }
  }
}

选项2：使用gcloud身份验证（不需要env变量）

{
  "mcpServers": {
    "google-sheets": {
      "command": "uvx",
      "args": ["mcp-google-sheets@latest"],
      "env": {}
    }
  }
}

*先决条件：*

*跑 gcloud auth application-default login --scopes=https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spreadsheets,https://www.googleapis.com/auth/drive 第一。*
*设置配额项目： `gcloud auth application-default set-quota-project

`*

🍎 macOS注意事项： 如果你得到一个 spawn uvx ENOENT 错误，替换 "command": "uvx" 随着 "command": "/Users/yourusername/.local/bin/uvx" （替换 yourusername 使用您的实际用户名）。

🟡 Config: Development (Running from cloned repo)

{
  "mcpServers": {
    "mcp-google-sheets-local": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/your/mcp-google-sheets",
        "mcp-google-sheets"
      ],
      "env": {
        "SERVICE_ACCOUNT_PATH": "/path/to/your/mcp-google-sheets/service_account.json",
        "DRIVE_FOLDER_ID": "your_drive_folder_id_here"
      }
    }
  }
}

*注：使用 --directory 标记以指定项目路径，并调整路径以匹配您的实际工作区位置。*

______________________________________________________________________

💬 克劳德提示示例

连接后，尝试以下提示：

“列出我有权访问的所有电子表格。”（或“在我的AI管理表格文件夹中”）
“创建一个名为‘2024年第三季度季度销售报告’的新电子表格。”
在“季度销售报告”电子表格中，获取Sheet1范围A1到E10的数据
将名为“摘要”的新工作表添加到具有ID的电子表格中 1aBcDeFgHiJkLmNoPqRsTuVwXyZ."
在我的“项目任务”电子表格的“任务”表中，将单元格B2更新为“进行中”
将这些行附加到电子表格中的“日志”表中 XYZ: [['2024-07-31', 'Task A Completed'], ['2024-08-01', 'Task B Started']]"
“获取电子表格“销售数据”和“库存盘点”的摘要。”
“与共享“团队度假时间表”电子表格 team@example.com 作为读者和 manager@example.com 作为一名作家。不要发送通知。"
“在我的‘销售报告’电子表格中创建一个柱状图，显示A1:B13范围内数据的月度收入。”
“在‘市场分析’表中添加一个饼图，数据来自A1:B5，标题为‘按产品划分的市场份额’。”
“在电子表格中 abc123，在Sheet1上从A1:C10范围创建一个折线图，标题为“增长趋势”，标签为“月份”和“收入”。"

______________________________________________________________________

🆔 ID参考指南

使用以下参考指南查找文档中引用的各种ID：

Google Cloud Project ID:
  https://console.cloud.google.com/apis/dashboard?project=sheets-mcp-server-123456
                                                          └───── Project ID ─────┘

Google Drive Folder ID:
  https://drive.google.com/drive/u/0/folders/1xcRQCU9xrNVBPTeNzHqx4hrG7yR91WIa
                                             └────────── Folder ID ──────────┘

Google Sheets Spreadsheet ID:
  https://docs.google.com/spreadsheets/d/25_-_raTaKjaVxu9nJzA7-FCrNhnkd3cXC54BPAOXemI/edit
                                         └───────────── Spreadsheet ID ─────────────┘

______________________________________________________________________

🤝 贡献

欢迎投稿！请打开一个问题来讨论bug或功能请求。拉取请求受到赞赏。

______________________________________________________________________

📄 许可证

此项目根据MIT许可证获得许可-请参阅许可证文件以获取详细信息。

______________________________________________________________________

🙏 学分

建于 FastMCP.
受启发于 kazz187/mcp谷歌电子表格.
使用Google API Python客户端库。

工具与能力

工具数量

19

资源数量

0

提示词数量

0

能力标签

developer-toolsgooglemcpspreadsheetmcp-server表格自动化Python本地部署

支持客户端

Claude DesktopClaude

数量来自来源目录的标注，具体工具清单以官方文档为准。

典型使用场景

让助手直接读代码

把仓库、提交记录和 issue 交给模型检索，补全和重构时不用来回复制文件。

在对话里跑命令

触发构建、测试和脚本，执行结果直接回到上下文，省去切终端。

接进开发流程

把 PR、CI 状态和代码审查接进助手，减少在几个工具之间跳。

选择建议

值得选的地方

工具数量 19 个，一次接入能覆盖的操作比单点工具更全。
有现成的安装命令，不用自己找入口，照着跑就能起服务。
已经适配 Claude Desktop、Claude，换客户端不用重新研究配置。

先想清楚的地方

stdio 方式要求本地装好 Python，换机器要重新装一遍。
第三方目录整理，版本更新和行为细节以官方仓库为准。

更适合

需要在开发工具场景里让模型直接调用外部能力的人。
已经在用 Claude Desktop 的用户，接入路径最短。
想先快速试一下、能接受在本地跑服务的人。

不太适合

完全不想在本地装环境的人。
需要厂商级 SLA 和技术支持的生产环境。

MCP Server	工具数	传输方式	安装命令	收录来源	最后核验
MCP Google Sheets MCP.so · 本页	19	stdio	有	3 个	2026-05-17
Git 838e2ec1 MCP World	12	stdio	有	2 个	2026-05-17
Markitdown MCP 2c653a5f MCP World	1	stdio	有	1 个	2026-05-17
Context7 MCP C671e75a MCP World	0	stdio	有	1 个	2026-05-17
Context7 831acf40 MCP World	0	stdio	有	1 个	2026-05-17

常见问题

5 条

MCP Google Sheets 怎么安装？

公开资料给出的安装命令是 uvx mcp-google-sheets@latest，运行环境为 Python。装完后按客户端要求写进 MCP 配置，重启客户端生效。

MCP Google Sheets 怎么在 Claude Desktop、Cursor 里配置？

它是stdio 本地进程，客户端配置里要写启动命令和参数，运行环境是 Python；保存后完全退出客户端再打开，配置才会生效。

MCP Google Sheets 收费吗？

本站只整理公开资料，不代收费用，也没有标注具体价格。是否收费取决于服务本身和背后的接口额度，正式使用前按官方说明确认。

MCP Google Sheets 需要 API Key 吗？

公开资料标注为无需认证，装好就能连；如果实际调用时报鉴权错误，按官方文档补上凭据。

MCP Google Sheets 支持哪些客户端？

公开资料标注支持 Claude Desktop、Claude；其他客户端只要能配置 MCP Server，也能用同样的命令或地址接入。

来源信息

MCP.so

mcp-google-sheets

This MCP server integrates with your Google Drive and Google Sheets, to enable creating and modifying spreadsheets.

mcp.so

/server/mcp-google-sheets/xing5

MCP World

mcp-google-sheets

一个连接MCP兼容客户端与Google Sheets API的Python服务器，实现AI驱动的电子表格自动化操作。

www.mcpworld.com

/detail/16ce57e510a16b969452ba04b69b7e11

Glama

mcp-google-sheets

A Model Context Protocol server that integrates with Google Drive and Google Sheets, enabling users to create, read, update, and manage spreadsheets through natural language commands.

glama.ai

/mcp/servers/xing5/mcp-google-sheets

参考链接

仓库入口

github.com

/xing5/mcp-google-sheets

来源标签

developer-toolsgooglemcpspreadsheetmcp-server表格自动化Python本地部署AI数据处理GoogleSheets集成

来源分类路径

developer-tools / 表格自动化

继续浏览同类 MCP

更多开发工具 MCP（20,396）返回 MCP 目录

上一个 MCP

MCP Google Docs

A lightweight MCP Server for integrating Google Docs, Sheets, and Slides with custom applications. Enables seamless document management, real-time collaboration, and API-based automation.

下一个 MCP

MCP Google Spreadsheet

MCP Server for Google Spreadsheet

选型结论

安装与配置

详细介绍

🤔 这是什么？

🚀 快速入门（使用 uvx)

✨ 主要特点

🎯 工具筛选（减少上下文使用）

如何启用工具筛选

可用工具名称

🛠️ 可用工具和资源

☁️ 谷歌云平台设置（详细）

🔑 身份验证和环境变量（详细）

方法A：服务帐户（建议用于服务器/自动化）✅

方法B:Auth2.0（交互式/个人使用）🧑‍💻

方法C：直接凭证注入（高级）🔒

方法D：应用程序默认凭据（ADC）🌐

身份验证优先级和摘要

⚙️ 运行服务器（详细）

方法1：使用 uvx （推荐给用户）

方法2：用于开发（克隆Repo）

方法3:Docker（SSE传输）

🔌 使用Claude Desktop

💬 克劳德提示示例

🆔 ID参考指南

🤝 贡献

📄 许可证

🙏 学分

工具与能力

典型使用场景

选择建议

同类对比

常见问题

MCP Google Sheets 怎么安装？

MCP Google Sheets 怎么在 Claude Desktop、Cursor 里配置？

MCP Google Sheets 收费吗？

MCP Google Sheets 需要 API Key 吗？

MCP Google Sheets 支持哪些客户端？

来源信息

继续浏览同类 MCP

🚀 快速入门（使用 `uvx`)

方法1：使用 `uvx` （推荐给用户）