谷歌工具mcp
这 最简单的方法 将您的AI代理连接到Google Workspace。
153工具 用于驱动器、文档、表格、Gmail、日历和表单——所有这些都在一个软件包中。一次安装，一次身份验证，就完成了。
npx -y google-tools-mcp setup为什么选择谷歌工具mcp？
- 一个安装命令。 没有克隆仓库，没有从源代码构建，没有Docker。就
npx -y google-tools-mcp它奏效了。 - 一次登录即可完成所有操作。 单个OAuth流为您提供驱动器、文档、表格、Gmail、日历和表单。无需处理多个令牌或服务器。
- 别挡你的路。 在您首次调用工具之前，浏览器不会弹出。之后，您的令牌将被保存，您将不会被再次询问。
- 阅读您驱动器中的任何内容。 PDF、Word文档（.docx）、电子表格——你的AI代理可以直接阅读它们。无需额外设置。
- 153个工具，零配置。 服务器启动时，每个工具都可用。发送电子邮件、创建文档、管理日历事件、构建表单——一切都在那里。
- 在Google帐户之间切换。 设置个人资料名称，并将工作和个人帐户完全分开。
- 没有遥测。没有追踪。完全开源。
快速开始
你可以在5分钟内开始跑步。
引导式设置（推荐）
运行安装向导——它将为您打开正确的Google Cloud Console页面，并自动保存您的凭据：
npx -y google-tools-mcp setup向导将引导您完成以下操作：
- 启用所有必需的Google API（在浏览器中打开）
- 配置OAuth同意屏幕
- 创建OAuth凭据
- 使用Google进行身份验证
设置后，只需将其添加到MCP客户端（请参阅 步骤3 在......下面
手动设置
Click to expand manual setup instructions
步骤1：创建Google OAuth凭据
- 去 谷歌云控制台
- 创建项目（或使用现有项目）
- 启用 谷歌文档API, 谷歌网页API, Google Drive API, Gmail API, 谷歌日历API，以及 谷歌表单API
- 首选 OAuth 同意屏幕 并对其进行配置（外部适用于个人使用）。如果您的应用程序的发布状态为 测试 （默认设置），您必须将您的Google帐户添加为测试用户--转到 OAuth 同意屏幕 → 测试用户 → 添加用户 并输入您的电子邮件。否则，谷歌将以“拒绝访问”或“应用程序未验证”错误阻止OAuth流。
- 首选 凭证 → 创建凭证 → OAuth客户端ID
- 选择 桌面应用程序 作为应用程序类型
- 下载凭据或记下您的 客户端ID 和 客户端密钥
第二步：提供您的凭据
选择 一 以下方法（以您喜欢的为准）：
选项A：使用 credentials.json
从Google Cloud Console下载JSON文件并将其放置在以下任一位置：
~/.config/google-tools-mcp/credentials.json (recommended — shared across projects)
./credentials.json (local to your project)就是这样——不需要环境变量。服务器会自动找到它。
选项B：创建 .env 文件
创建一个 .env 文件位于以下任一位置：
~/.config/google-tools-mcp/.env (recommended — shared across projects)
./.env (local to your project)内容如下：
GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=your-client-secret选项C：在MCP配置中设置环境变量
将凭据直接添加到MCP配置中：
{
"mcpServers": {
"google": {
"command": "npx",
"args": ["-y", "google-tools-mcp"],
"env": {
"GOOGLE_CLIENT_ID": "your-client-id",
"GOOGLE_CLIENT_SECRET": "your-client-secret"
}
}
}
}凭证查找顺序： 环境变量→~/.config/google-tools-mcp/.env→ 项目根目录.env→~/.config/google-tools-mcp/credentials.json→ 项目根目录credentials.json
步骤3：添加到MCP客户端
克劳德代码（推荐）
用户范围 （适用于所有项目）：
claude mcp add -s user google -- npx -y google-tools-mcp项目范围 （仅在当前项目中可用）：
claude mcp add google -- npx -y google-tools-mcp使用env变量（选项C）：
# User-scope
claude mcp add -s user google \
-e GOOGLE_CLIENT_ID=your-client-id \
-e GOOGLE_CLIENT_SECRET=your-client-secret \
-- npx -y google-tools-mcp
# Project-scope
claude mcp add google \
-e GOOGLE_CLIENT_ID=your-client-id \
-e GOOGLE_CLIENT_SECRET=your-client-secret \
-- npx -y google-tools-mcp项目本地安装（附剖面图）
通过 claude CLI：
claude mcp add -s user google \
-e GOOGLE_MCP_PROFILE=myprofile \
-- npx -y google-tools-mcp或者手动输入 .mcp.json:
{
"mcpServers": {
"google": {
"command": "npx",
"args": ["-y", "google-tools-mcp"],
"env": {
"GOOGLE_MCP_PROFILE": "myprofile"
}
}
}
}其他MCP客户端
将其添加到您的MCP配置中（例如。， .mcp.json, claude_desktop_config.json):
{
"mcpServers": {
"google": {
"command": "npx",
"args": ["-y", "google-tools-mcp"]
}
}
}如果使用选项C，请添加 "env" 用你的 GOOGLE_CLIENT_ID 和 GOOGLE_CLIENT_SECRET.
步骤4：身份验证
在您的第一次工具调用中，服务器将自动打开您的浏览器以获得Google OAuth同意。登录并授予访问权限——令牌保存到 ~/.config/google-tools-mcp/token.json 以备将来使用。
您还可以随时手动运行身份验证流：
npx google-tools-mcp auth多账户支持
设置 GOOGLE_MCP_PROFILE env-var为每个配置文件使用单独的令牌：
{
"env": {
"GOOGLE_MCP_PROFILE": "work"
}
}这将令牌存储在 ~/.config/google-tools-mcp/work/ 而不是默认目录。
工具类别
files （18工具）
Google Drive文件管理和内容读取。
listDriveFiles, searchDocuments, getFileInfo, getFilePath, createFolder, listFolderContents, getFolderInfo, moveFile, copyFile, renameFile, deleteFile, createDocument, createDocumentFromTemplate, listSharedDrives, listSharedWithMe, downloadFile, readFile, searchFileContents
documents （22工具）
支持markdown的谷歌文档读/写/格式化。
readDocument, appendText, deleteRange, modifyText, findAndReplace, insertTable, insertTableWithData, insertPageBreak, insertImage, listTabs, addTab, renameTab, applyParagraphStyle, getFormatting, addComment, deleteComment, getComment, listComments, replyToComment, resolveComment, appendMarkdown, replaceDocumentWithMarkdown
spreadsheets （29工具）
谷歌表格操作。
readSpreadsheet, writeSpreadsheet, batchWrite, appendRows, clearRange, createSpreadsheet, getSpreadsheetInfo, addSheet, deleteSheet, duplicateSheet, renameSheet, formatCells, readCellFormat, autoResizeColumns, freezeRowsAndColumns, setColumnWidths, addConditionalFormatting, copyFormatting, setDropdownValidation, createTable, deleteTable, getTable, listTables, appendTableRows, updateTableRange, insertChart, deleteChart, groupRows, ungroupAllRows
email （19工具）
Gmail邮件和草稿。
send_message, reply_message, forward_message, get_message, list_messages, modify_message, delete_message, trash_message, untrash_message, batch_delete_messages, batch_modify_messages, batch_get_messages, get_attachment, create_draft, update_draft, delete_draft, get_draft, list_drafts, send_draft
email_threads （7工具）
Gmail线程级操作。
get_thread, list_threads, batch_get_threads, modify_thread, delete_thread, trash_thread, untrash_thread
email_labels （6个工具）
Gmail标签管理。
create_label, delete_label, get_label, list_labels, patch_label, update_label
email_settings （37工具）
Gmail管理和配置。
get_auto_forwarding, update_auto_forwarding, get_imap, update_imap, get_language, update_language, get_pop, update_pop, get_vacation, update_vacation, add_delegate, remove_delegate, get_delegate, list_delegates, create_filter, delete_filter, get_filter, list_filters, create_forwarding_address, delete_forwarding_address, get_forwarding_address, list_forwarding_addresses, create_send_as, delete_send_as, get_send_as, list_send_as, patch_send_as, update_send_as, verify_send_as, delete_smime_info, get_smime_info, insert_smime_info, list_smime_info, set_default_smime_info, get_profile, watch_mailbox, stop_mail_watch
calendar （8工具）
谷歌日历——事件、可用性和日历管理。
list_calendars, get_events, manage_event, get_busy, get_free, move_event, list_recurring_event_instances, manage_calendar
forms （6个工具）
Google Forms--创建/读取表单、管理响应和发布设置。
create_form, get_form, batch_update_form, get_form_response, list_form_responses, set_publish_settings
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
GOOGLE_CLIENT_ID | 否\* | OAuth 2.0客户端ID |
GOOGLE_CLIENT_SECRET | 否\* | OAuth 2.0客户端密码 |
GOOGLE_MCP_PROFILE | 否 | 多帐户支持的配置文件名称（见上文） |
LOG_LEVEL | 没有 | debug, info, warn, error，或 silent |
GOOGLE_MCP_LOG_FILE | 否 | 设置为 1 登录到 ~/.config/google-tools-mcp/server.log，或设置为自定义文件路径 |
SERVICE_ACCOUNT_PATH | 否 | 服务帐户JSON密钥的路径（OAuth的替代方案） |
GOOGLE_IMPERSONATE_USER | 否 | 使用服务帐户冒充的电子邮件 |
\*如果您通过以下方式提供凭据，则不需要作为env变量 .env 文件或 credentials.json （参见 步骤2).
从gdrive工具mcp/gmail工具mcp迁移
- 将两个MCP服务器条目替换为一个
google-tools-mcp进入 - 重新验证（组合服务器在以下位置使用自己的配置目录
~/.config/google-tools-mcp/) - 所有工具均可立即使用，无需进行发现步骤
许可证
麻省理工学院