Skip to main content
Glama

Google MCP 工具

铁匠徽章

这是针对MCP 协议的 Google 原生工具(例如 Gmail、日历)的集合,旨在与 Claude 或 Cursor 等 AI 客户端无缝集成。

{
  "mcpServers": {
    "google-mcp": {
      "command": "bunx",
      "args": ["--no-cache", "google-mcp@latest"],
      "env": {
        // Either can be used, but not both
        // Use OAuth
        "GOOGLE_OAUTH_CLIENT_ID": "<YOUR_CLIENT_ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "GOOGLE_OAUTH_TOKEN_PATH": "<PATH_TO_STORE_TOKENS> CAN_BE_ANYWHERE_ON_YOUR_SYSTEM",
        // Use Service Account
        "GOOGLE_CLIENT_EMAIL": "<YOUR_SERVICE_ACCOUNT_EMAIL>",
        "GOOGLE_PRIVATE_KEY": "<YOUR_SERVICE_ACCOUNT_PRIVATE_KEY>",
        "GMAIL_USER_TO_IMPERSONATE": "<USER_TO_IMPERSONATE>"
      }
    }
  }
}

特征

  • Gmail:

    • 发送具有多个收件人(收件人、抄送人、密送人)和附件的电子邮件。

    • 列出带有自定义查询、标签和结果限制的电子邮件。

    • 通过 ID 阅读特定的电子邮件。

    • 管理标签(添加、删除、列出)。

    • 起草和删除电子邮件。

  • 日历:

    • 列出日历并设置默认日历。

    • 创建具有详细信息(摘要、开始/结束时间、参加者等)的活动。

    • 使用可自定义的过滤器列出即将发生的事件。

    • 更新或删除现有事件。

    • 寻找空闲的时间段进行安排。

  • 驾驶:

    • 使用搜索查询进行过滤

    • 按修改日期或其他标准排序

    • 自定义显示数量

    • 查看详细文件元数据

    • 读取文件内容(文本、文档、电子表格)

    • 创建具有指定内容的新文件

    • 更新现有文件

    • 删除文件(垃圾文件或永久文件)

    • 以特定权限共享文件

  • 任务:

    • 查看所有任务列表

    • 创建新的任务列表

    • 删除现有任务列表

    • 设置默认任务列表

    • 使用过滤器列出任务

    • 查看任务详细信息

    • 创建带有标题、注释和截止日期的任务

    • 更新任务属性

    • 将任务标记为完成

    • 删除任务

  • TODO 计划:

    • Google 通讯录:搜索和管理联系人。

    • 还有更多...

您可以链接工作流程的命令,例如:

“列出我未读的电子邮件,起草对最新一封的回复,并安排明天下午 2 点的后续会议。”

手动安装

  1. 先决条件:

    • 安装Bun:

    brew install oven-sh/bun/bun  # macOS/Linux with Homebrew
  2. 设置 OAuth:

    • 在Google Cloud Console中创建一个 Google Cloud 项目。

    • 设置 OAuth 2.0 凭证(客户端 ID、客户端密钥)。

    • 选择桌面应用程序类型。

    • 如果使用测试模式,请将您的电子邮件添加到测试用户列表。

    • 确保为所需服务(Gmail、日历、云端硬盘等)启用 API 访问。

  3. 配置您的客户端:编辑您的 claude_desktop_config.json(或您的客户端的等效配置文件):

{
  "mcpServers": {
    "google-mcp": {
      "command": "bunx",
      "args": ["--no-cache", "google-mcp@latest"],
      "env": {
        // Either can be used, but not both
        // Use OAuth
        "GOOGLE_OAUTH_CLIENT_ID": "<YOUR_CLIENT_ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "GOOGLE_OAUTH_TOKEN_PATH": "<PATH_TO_STORE_TOKENS>",
        // Use Service Account
        "GOOGLE_CLIENT_EMAIL": "<YOUR_SERVICE_ACCOUNT_EMAIL>",
        "GOOGLE_PRIVATE_KEY": "<YOUR_SERVICE_ACCOUNT_PRIVATE_KEY>",
        "GMAIL_USER_TO_IMPERSONATE": "<USER_TO_IMPERSONATE>"
      }
    }
  }
}
  1. 认证:

    • 首次运行服务器时,它会打开浏览器进行 OAuth 身份验证。按照提示授予访问权限,令牌将保存到 GOOGLE_OAUTH_TOKEN_PATH。

Related MCP server: Google Search MCP Server

用法

现在,让 Claude 使用google-mcp工具。

Send an email to jane.doe@example.com with the subject "Meeting Notes" and body "Here are the notes from today."
List my upcoming calendar events for the next 3 days.
Create a calendar event titled "Team Sync" tomorrow at 10 AM for 1 hour.

本地开发

git clone https://github.com/vakharwalad23/google-mcp.git
cd google-mcp
bun install
bun run index.ts

感谢您使用 Google MCP 工具!如果您有任何问题或建议,欢迎随时提交问题或为项目做出贡献。

使用这些工具并享受乐趣吧!!

Available Tools

32 tools
google_calendar_create_eventC

Create a new event in Google Calendar

Inputs: end (required), start (required), summary (required), attendees, +5 more.

google_calendar_delete_eventC

Delete an event from Google Calendar

Inputs: eventId (required), calendarId.

google_calendar_find_free_timeC

Find available time slots between events

Inputs: duration (required), endDate (required), startDate (required), calendarIds.

google_calendar_get_eventC

Get detailed information about a specific event

Inputs: eventId (required), calendarId.

google_calendar_get_eventsC

Retrieve upcoming events from Google Calendar

Inputs: calendarId, limit, q, showDeleted, +2 more.

google_calendar_list_calendarsB

List all available calendars

Inputs: no named parameters.

google_calendar_set_defaultC

Set the default calendar ID for operations

Inputs: calendarId (required).

google_calendar_update_eventC

Update an existing event in Google Calendar

Inputs: eventId (required), attendees, calendarId, colorId, +6 more.

google_drive_create_fileC

Create a new file in Google Drive

Inputs: content (required), name (required), folderId, mimeType.

google_drive_delete_fileC

Delete a file from Google Drive

Inputs: fileId (required), permanently.

google_drive_get_file_contentC

Get the content of a file from Google Drive

Inputs: fileId (required).

google_drive_list_filesC

List files from Google Drive

Inputs: fields, orderBy, pageSize, query.

google_drive_share_fileC

Share a file with another user

Inputs: emailAddress (required), fileId (required), message, role, +1 more.

google_drive_update_fileC

Update the content of an existing file in Google Drive

Inputs: content (required), fileId (required), mimeType.

google_gmail_delete_emailC

Delete or trash an email

Inputs: messageId (required), permanently.

google_gmail_draft_emailC

Create a draft email

Inputs: body (required), subject (required), to (required), bcc, +2 more.

google_gmail_get_emailB

Get detailed information about a specific email

Inputs: messageId (required), format.

google_gmail_get_email_by_indexB

Get email by its index from the most recent search results

Inputs: index (required), format.

google_gmail_list_emailsC

List emails from a specific label or folder

Inputs: labelIds, maxResults, query.

google_gmail_list_labelsB

List all available Gmail labels

Inputs: no named parameters.

google_gmail_modify_labelsC

Add or remove labels from an email

Inputs: messageId (required), addLabelIds, removeLabelIds.

google_gmail_send_emailC

Send a new email

Inputs: body (required), subject (required), to (required), bcc, +2 more.

google_tasks_complete_taskC

Mark a task as completed

Inputs: taskId (required), taskListId.

google_tasks_create_taskC

Create a new task

Inputs: title (required), due, notes, taskListId.

google_tasks_create_tasklistC

Create a new task list

Inputs: title (required).

google_tasks_delete_taskC

Delete a task

Inputs: taskId (required), taskListId.

google_tasks_delete_tasklistC

Delete a task list

Inputs: taskListId (required).

google_tasks_get_taskC

Get details about a specific task

Inputs: taskId (required), taskListId.

google_tasks_list_tasklistsB

List all available task lists

Inputs: no named parameters.

google_tasks_list_tasksC

List tasks from a task list

Inputs: showCompleted, taskListId.

google_tasks_set_default_listC

Set the default task list ID for operations

Inputs: taskListId (required).

google_tasks_update_taskC

Update an existing task

Inputs: taskId (required), due, notes, status, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 32 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose with no ambiguity, as each is scoped to a specific Google service (Calendar, Drive, Gmail, Tasks) and a specific action on a resource (e.g., create, delete, list). Overlap is minimal, such as 'google_calendar_get_event' and 'google_calendar_get_events' being clearly differentiated by singular vs. plural.

    Naming Consistency5/5

    Tool names follow a highly consistent verb_noun pattern throughout, with a clear structure: 'google_service_action_resource' (e.g., 'google_calendar_create_event'). All tools use snake_case uniformly, and verbs are predictable (create, delete, get, list, update, etc.), making the set easy to navigate.

    Tool Count3/5

    With 32 tools, the count is borderline high for a single server, as it covers multiple Google services (Calendar, Drive, Gmail, Tasks). While each service is well-scoped individually, the overall set feels heavy and might be better split into separate servers, but it's not extreme (e.g., not 50+ tools).

    Completeness5/5

    The tool surface provides complete CRUD/lifecycle coverage for each Google service domain, with no obvious gaps. For example, Calendar has create, get, list, update, delete, plus utilities like find_free_time; Gmail includes send, draft, get, list, delete, and label management; ensuring agents can handle full workflows without dead ends.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      An MCP (Model Context Protocol) server that provides Google search capabilities and webpage content analysis tools. This server enables AI models to perform Google searches and analyze webpage content programmatically.
      262
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A locally-hosted MCP server that integrates Gmail, Google Calendar, and Google Drive to provide AI-powered management of emails, events, and files. It enables tool-based interactions like sending emails, creating calendar events, and searching Drive files through clients like Cursor and Claude Desktop.
      -