Yet Another Google MCP

🔧 MCP谷歌工具服务器

功能齐全 模型上下文协议 谷歌工作区服务器。\ 让您的AI助手实时访问Drive、Gmail、日历、表格、文档和应用程序脚本。

英文文档 · 俄语文档

______________________________________________________________________

✨ 它能做什么

______________________________________________________________________

🧩 MCP图元

此服务器公开了所有三种MCP基元类型：

🛠 工具

50+可执行操作

由AI按需调用。

每个工具都有注释

readOnlyHint / destructiveHint

因此，客户可以在采取危险行动之前发出警告。

📦 资源

只读数据快照

直接附加实时谷歌数据

转到AI上下文窗口

无需调用工具。

支持静态URI和模板。

💬 提示

可重复使用的AI模板

在MCP客户端中选择提示

获取实时数据并开始

有条理的谈话

只需单击一下。

______________________________________________________________________

🚀 快速开始

1--安装依赖项

pip install -r requirements.txt

2--设置谷歌OAuth

在中创建OAuth 2.0客户端ID 谷歌云控制台，下载JSON，并记下其路径。

完整的分步指南： docs/AUTH_SETUP.md · docs/ru/AUTH_SETUP.md

3--配置服务器

cp config.example.yaml config.yaml
# then edit config.yaml — set paths and choose MCP_AUTH_TOKEN

💡 How to create MCP_AUTH_TOKEN

MCP_AUTH_TOKEN 是您选择的秘密字符串。你可以把它看作是 此MCP服务器的本地激活密钥，而不是作为网络安全层或身份验证机制。

• 服务器在开始处理工具之前只检查此令牌是否已配置——这是一个额外的安全步骤，可以避免在没有明确设置的情况下意外运行。
• 发明任何随机字符串，例如。 MySecretToken_2026! 或者使用密码生成器。
• 建议长度：16+个字符。避免重复使用密码。
• 设置它 config.yaml → mcp_auth_token: "your_token" 或 作为env变量 MCP_AUTH_TOKEN.

令牌从不发送到任何地方——它只在服务器进程内部进行本地检查。确实如此 不 限制服务器运行后AI代理可以执行的操作。有关更多详细信息，请参阅 docs/SECURITY.md / docs/ru/SECURITY.md.

4--连接IDE

替换 具有此存储库的绝对路径，以及 your_token_here 用你的代币。

Cursor — .cursor/mcp.json or ~/.cursor/mcp.json

{
  "mcpServers": {
    "google-tools": {
      "command": "python",
      "args": ["
\\server.py"],
      "env": {
        "MCP_AUTH_TOKEN": "your_token_here",
        "MCP_CONFIG_FILE": "
\\config.yaml"
      }
    }
  }
}

Windsurf — %APPDATA%\Codeium\Windsurf\mcp_config.json (Windows)

{
  "mcpServers": {
    "google-tools": {
      "command": "python",
      "args": ["
\\server.py"],
      "env": {
        "MCP_AUTH_TOKEN": "your_token_here",
        "MCP_CONFIG_FILE": "
\\config.yaml"
      }
    }
  }
}

VS Code (Copilot MCP) — .vscode/mcp.json or MCP: Open User Configuration

用途 servers （不是 mcpServers).需要VS代码1.102+和启用副驾驶。

{
  "servers": {
    "google-tools": {
      "type": "stdio",
      "command": "python",
      "args": ["
\\server.py"],
      "env": {
        "MCP_AUTH_TOKEN": "your_token_here",
        "MCP_CONFIG_FILE": "
\\config.yaml"
      }
    }
  }
}

Other IDEs — generic MCP stdio config

使用相同的 command / args / env根密钥可能是 mcpServers 或 servers.

{
  "mcpServers": {
    "google-tools": {
      "command": "python",
      "args": ["
\\server.py"],
      "env": {
        "MCP_AUTH_TOKEN": "your_token_here",
        "MCP_CONFIG_FILE": "
\\config.yaml"
      }
    }
  }
}

5--烟雾检查

连接后，呼叫 get_gmail_profile() 在您的AI客户端中。\ 如果OAuth配置正确，它应该返回经过身份验证的Gmail地址。

______________________________________________________________________

📖 使用示例

Basic operations

# Verify authentication
Tool: get_gmail_profile
→ Authenticated Gmail address: user@example.com

# Search for files in Drive
Tool: find_files
Arguments: {"query": "name contains 'budget'"}
→ - Budget_2026.xlsx (ID: 1a2b3c...) [spreadsheet]

# Read a Google Sheet
Tool: read_sheet
Arguments: {"spreadsheet_id": "1a2b3c4d5e...", "range_name": "Sheet1!A1:C10"}
→ | Name | Email     | Status |
  | John | j@corp.io | Active |

# Create a draft email (safe by default — never sends without draft_mode=false)
Tool: send_email
Arguments: {"to": "colleague@example.com", "subject": "Notes", "body_text": "...", "draft_mode": true}
→ EMAIL DRAFT CREATED (ID: r1234...) — saved as draft, not sent.

Resources — attach live data to context

# Recent Drive files (no arguments needed)
Resource URI: gdrive://recent

# Unread inbox snapshot
Resource URI: gmail://inbox

# This week's calendar
Resource URI: gcalendar://upcoming

# Specific spreadsheet range
Resource URI: gsheets://1a2b3c4d5e.../Sheet1!A1:D20

# Specific Google Doc
Resource URI: gdocs://1a2b3c4d5e...

Prompts — one-click AI workflows

______________________________________________________________________

🛡 安全特性

⚠️ 您的AI代理可以访问您通过OAuth授权的所有数据。 对敏感帐户使用只读范围。看 docs/SECURITY.md.

______________________________________________________________________

⚙️ 配置参考

config.yaml 钥匙

MCP_CONFIG_FILE --指向您的 config.yaml。在IDE中设置此项 env 块。\ 环境变量始终覆盖配置文件值。

Minimal config.yaml example

client_secrets_file: "C:\\Users\\you\\.google\\oauth.keys.json"
token_file: "C:\\Users\\you\\.google\\token.json"
mcp_auth_token: "MySecretToken_2026!"
log_level: "INFO"

______________________________________________________________________

📦 完整工具列表

📁 Drive (8 tools)

📊 Sheets (11 tools)

📄 Docs (5 tools)

📧 Gmail (11 tools)

📅 Calendar (4 tools)

⚙️ Apps Script (6 tools)

______________________________________________________________________

📚 文档

🇬🇧 英语

🇷🇺 俄语

文档描述 |----------|----------| | AUTH_SETUP.md Google OAuth的一步一步 | 工具_参考.md –工具、资源和插件的完整目录→ | 安全.md –Oauth scopes，保护，推荐→ | IDE_SETUP.md –配置Cursor、Windsurf、VS Code和其他IDE→

______________________________________________________________________

⚠️ 责任通知

您有责任了解此服务器执行操作的风险和后果。\ 您可以自行决定使用它，并遵循您组织的安全策略。

______________________________________________________________________