AY

artoxem/yet-another-google-mcp

开发工具

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

10 stars 3 forks 质量 73 趋势 18MIT

Model Context Protocol server exposing Google Drive, Sheets, Docs, Gmail, Calendar, and Apps Script as MCP tools. Python, OAuth 2.

概览

Give your AI assistant real-time access to Drive, Gmail, Calendar, Sheets, Docs, and Apps Script. This server exposes all three MCP primitive types: Called by the AI on demand. Every tool is annotated with readOnlyHint / destructiveHint so clients can warn before risky actions. Attach live Google data directly to the AI context window without calling a tool. Supports static URIs and templates. Select a prompt in your MCP client to fetch live data and start a structured conversation in one click. Create an OAuth 2.0 Client ID in Google Cloud Console, download the JSON, and note its path. docs/AUTH_SETUP.md · docs/ru/AUTH_SETUP.md MCP_AUTH_TOKEN is a secret string you choose. You can think of it as a , not as a network security layer or authentication mechanism.

README

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


✨ What it can do

Service Capabilities
📁 Google Drive Search, copy, move, share, manage permissions
📊 Google Sheets Read/write ranges, named ranges, filter views, find & replace, CSV export
📄 Google Docs Read, create, append text, fill templates, export to PDF
📧 Gmail Draft, send, search, archive, label, delete with confirmation
📅 Google Calendar List events, find free slots, create meetings with attendees
⚙️ Apps Script Read, staged updates, auto-backup, rollback
🔗 Resources Attach live Drive / Gmail / Calendar / Sheets / Docs snapshots to AI context
💬 Prompts Ready-made AI templates: summarize inbox, analyze spreadsheet, plan week, search files

🧩 MCP Primitives

This server exposes all three MCP primitive types:


🚀 Quick Start

1 — Install dependencies

pip install -r requirements.txt

2 — Set up Google OAuth

Create an OAuth 2.0 Client ID in Google Cloud Console, download the JSON, and note its path.

Full step-by-step guide: docs/AUTH_SETUP.md · docs/ru/AUTH_SETUP.md

3 — Configure the server

cp config.example.yaml config.yaml
# then edit config.yaml — set paths and choose MCP_AUTH_TOKEN
在 GitHub 查看完整 README

安装

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

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

配置

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