Google Workspace MCP Server
MCP server providing Claude access to Google Drive, Docs, Sheets, Slides, Calendar, Gmail, and Contacts.
Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
npx -y @dguido/[email protected]Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
claude mcp add dguido-google-workspace-mcp -- npx -y @dguido/google-workspace-mcp@3.4.4รันในเทอร์มินัล
{ "mcpServers": { "dguido-google-workspace-mcp": { "command": "npx", "args": [ "-y", "@dguido/[email protected]" ] } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
MCP server providing Claude access to Google Drive, Docs, Sheets, Slides, Calendar, Gmail, and Contacts.
Google Workspace MCP Server - Model Context Protocol server providing secure access to Google Drive, Docs, Sheets, Slides, Calendar, and Gmail through MCP clients e.g. Claude Desktop
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"google-workspace": {
"command": "npx",
"args": ["@dguido/google-workspace-mcp"],
"env": {
"GOOGLE_CLIENT_ID": "YOUR_CLIENT_ID.apps.googleusercontent.com",
"GOOGLE_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
"GOOGLE_WORKSPACE_SERVICES": "drive,gmail,calendar"
}
}
}
}
That's it. On first tool call, a browser window opens for Google OAuth consent. Tokens are saved automatically.
Download the credentials JSON from Google Cloud Console and save to ~/.config/google-workspace-mcp/credentials.json, then authenticate manually:
npx @dguido/google-workspace-mcp auth
See Advanced Configuration for file-based setup, named profiles, and multi-account setup.
Create a Google Doc called "Project Plan" in /Work/Projects with an outline for Q1.
Search for files containing "budget" and organize them into the Finance folder.
Create a presentation called "Product Roadmap" with slides for Q1 milestones.
drive.file, documents, spreadsheets, presentations, drive, drive.readonly, calendar, gmail.modify, gmail.labels, contactsBoth credentials and tokens are stored in ~/.config/google-workspace-mcp/ by default:
For LLM-optimized responses that reduce token usage by 20-50%, enable TOON format:
{
"mcpServers": {
"google-workspace": {
"command": "npx",
"args": ["@dguido/google-workspace-mcp"],
"env": {
"GOOGLE_WORKSPACE_SERVICES": "drive,gmail,calendar",
"GOOGLE_WORKSPACE_TOON_FORMAT": "true"
}
}
}
}
TOON (Token-Oriented Object Notation) encodes structured responses more compactly than JSON by eliminating repeated field names. Savings are highest for list operations (calendars, events, emails, filters).
By default, we recommend enabling only the core services (drive,gmail,calendar) as shown in Quick Start. This provides file management, email, and calendar capabilities without the complexity of document editing tools.
To enable additional services, add them to GOOGLE_WORKSPACE_SERVICES:
{
"mcpServers": {
"google-workspace": {
"command": "npx",
"args": ["@dguido/google-workspace-mcp"],
"env": {
"GOOGLE_WORKSPACE_SERVICES": "drive,gmail,calendar,docs,sheets,slides"
}
}
}
}
Available services: drive, docs, sheets, slides, calendar, gmail, contacts
GOOGLE_WORKSPACE_SERVICES entirely to enable all servicescreate_file, update_file, get_file_content) require drive, docs, sheets, and slidesSee Advanced Configuration for named profiles, multi-account setup, and environment variables.
search listFolder createFolder createTextFile updateTextFile deleteItem renameItem moveItem copyFile getFileMetadata exportFile shareFile getSharing removePermission listRevisions restoreRevision downloadFile uploadFile getStorageQuota starFile resolveFilePath batchDelete batchRestore batchMove batchShare listTrash restoreFromTrash emptyTrash getFolderTree
createGoogleDoc updateGoogleDoc getGoogleDocContent appendToDoc insertTextInDoc deleteTextInDoc replaceTextInDoc formatGoogleDocRange
createGoogleSheet updateGoogleSheet getGoogleSheetContent formatGoogleSheetCells mergeGoogleSheetCells addGoogleSheetConditionalFormat sheetTabs
createGoogleSlides updateGoogleSlides getGoogleSlidesContent formatSlidesText formatSlidesShape formatSlideBackground createGoogleSlidesTextBox createGoogleSlidesShape slidesSpeakerNotes listSlidePages
listCalendars listEvents getEvent createEvent updateEvent deleteEvent findFreeTime
sendEmail draftEmail readEmail searchEmails deleteEmail modifyEmail downloadAttachment listLabels getOrCreateLabel updateLabel deleteLabel createFilter listFilters deleteFilter
listContacts getContact searchContacts createContact updateContact deleteContact
createFile updateFile getFileContent
Set GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET env vars in your MCP config, or save your credentials file to ~/.config/google-workspace-mcp/credentials.json.
Ensure credential type is "Desktop app" (not "Web application"). The server uses an ephemeral port assigned by the OS, so no specific ports need to be available.
Apps in "Testing" status expire tokens after 7 days. Re-authenticate:
rm ~/.config/google-workspace-mcp/tokens.json
npx @dguido/google-workspace-mcp auth
To avoid weekly re-authentication: Publish your OAuth app (see Avoiding Token Expiry below).
Enable the missing API in Google Cloud Console > APIs & Services > Library.
Revoke app access at Google Account Permissions, clear tokens, and re-authenticate.
OAuth apps in "Testing" status automatically expire tokens after 7 days. To avoid weekly re-authentication:
Note: Publishing makes your app available to any Google user, but since you control the OAuth credentials, only you can authenticate.
If you have a Google Workspace account:
Use get_status to check token age. Tokens older than 6 days show a warning automatically.
npm install
npm run build # Compile TypeScript
npm run check # typecheck + lint + format check
npm test # Run tests
See Contributing Guide for project structure and development workflow.
This project is a substantial rewrite of piotr-agier/google-drive-mcp, originally created by Piotr Agier.
MIT - See LICENSE file for details.
Google Workspace MCP Server - Model Context Protocol server providing secure access to Google Drive, Docs, Sheets, Slides, Calendar, and Gmail through MCP clients e.g. Claude Desktop
{ "mcpServers": { "dguido-google-workspace-mcp": { "command": "npx", "args": [ "-y", "@dguido/[email protected]" ] } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
@dguido/google Workspace ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-15 Google Workspace MCP Server - Model Context Protocol server providing secure access to Google Drive, Docs, Sheets, Slides, Calendar, and Gmail through MCP clients e.g. Claude Desktop