gsuite-mcp
Complete Google Workspace MCP server — Gmail, Calendar, Drive, Docs, Tasks, Sheets, Slides, Forms, Contacts, Meet, Drive Activity, and Chat. Single Go binary with true multi-account support.
Power your agent
การติดตั้งจากผู้เผยแพร่ ไม่ใช่เอนด์พอยต์ของ PlugMCP
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.
เปิดจากผู้เผยแพร่
Complete Google Workspace MCP server — Gmail, Calendar, Drive, Docs, Tasks, Sheets, Slides, Forms, Contacts, Meet, Drive Activity, and Chat. Single Go binary with true multi-account support.
Complete Google Workspace MCP server — Gmail, Calendar, Docs, Tasks, Sheets, Contacts, Drive. Single Go binary with multi-account support.
→ Full Installation Guide — Get running in under 10 minutes
git clone https://github.com/aliwatters/gsuite-mcp.git
cd gsuite-mcp
./install.sh
# Authenticate
gsuite-mcp auth personal
# Add to your MCP client config
install.sh builds the MCP harness binary to ~/.local/libexec/gsuite-mcp and also installs a PATH/CLI copy at ~/.local/bin/gsuite-mcp. It skips a rebuild only when both installed binaries match HEAD. Re-run with --force or FORCE_REBUILD=1 to force a rebuild. Set INSTALL_PREFIX to change the install location.
"account": "work"Full inbox management: search, read, send, reply, archive, trash, labels, filters, drafts, threads, batch operations, vacation responder, send-as aliases, delegation.
Complete calendar control: list events, create/update/delete, recurring events, free/busy queries, Google Meet integration.
File management with shared drive support: search (with friendly file type filter), upload, download, list, create folders, move, copy, trash, delete, share, permissions, shareable links, comments & replies, version history (revisions).
Document creation and editing: create, read, structure, append, insert, replace, delete, formatting (bold, italic, headings, format-by-find), lists, tables, images, headers/footers, markdown export, PDF export, import, named ranges, suggested edits.
Task management: lists, tasks, subtasks, due dates, completion, reordering.
Spreadsheet operations: read, write, append, batch operations, create, cell formatting, conditional formatting, data validation, charts, pivot tables.
Presentation operations: get presentation metadata and structure, get individual slide details, slide thumbnails, create presentations, batch update (add/modify/delete slides, text, shapes, images).
Form management: get form structure and questions, create forms, batch update (add/update/delete questions, settings), list responses, get individual responses.
Contact management: list, search, create, update, delete, contact groups.
Conference record retrieval: list/get conference records, list participants, list/get transcripts, get transcript entries for meeting summarization.
Audit trail queries: query activity history for Drive files and folders (who edited, created, moved, shared, with time range and action type filters).
Google Chat management: list/get/create spaces, list/get/send messages, thread replies, add/remove reactions, list space members.
Header detail on gmail_get/gmail_get_message/gmail_get_messages/gmail_get_thread/gmail_get_draft (breaking change): these tools return a curated, lowercase headers map whenever Gmail returns a message payload (format: "minimal" returns none) (date, from, to, cc, bcc, subject, message-id, reply-to, sender, delivered-to, x-original-to, return-path, in-reply-to, references, list-unsubscribe, list-unsubscribe-post, list-id, auto-submitted, precedence, content-type, authentication-results, received-spf, plus dkim-signature=present when available). Gmail's full ordered raw MIME header list — payload_headers, which preserves repeated headers like multiple Received lines — is no longer included by default. Pass headers: "raw" to opt in for SPF/DKIM/ARC debugging; a batch of messages with payload_headers inlined can blow past output size limits (#199). body_format defaults to "text", which already returns just the decoded plain-text body with no MIME multipart scaffolding.
Example:
gmail_resolve_web_id(id="https://mail.google.com/mail/u/0/#inbox/FMfcgzQgLrxVJjTVKwvFRgbdLPFsxXfj")
# → { thread_id: "552634d52b0bc546", message_id: "6dd2cf16cc577e3", id_kind: "FMfcg" }
# If those decoded IDs are not fetchable for the selected account, the tool returns
# an explicit error recommending gmail_search instead of returning unusable IDs.
gmail_resolve_web_id(id="thread-f:1821570065795440641")
# → { thread_id: "19478452e138e001", id_kind: "thread-f" }
Scripts can invoke registered tools directly. The call command does not start a browser or an auth server; authenticate separately with gsuite-mcp auth <email> when needed. Results are JSON on stdout, and errors are written to stderr. Exit codes are 0 for success, 1 for tool or argument errors, and 2 when authentication is required.
gsuite-mcp call drive_list --account [email protected] --args '{"folder_id":"root"}'
gsuite-mcp call drive_upload --account [email protected] --args-file upload-args.json
For uploads, pass file_path in the JSON arguments to stream a local file without loading it into the argument string. drive_list and drive_search return next_page_token (empty when complete) and truncated so scripts can follow every page.
All tools accept an optional account parameter:
{"query": "is:unread", "account": "work"}
{"message_id": "abc123", "account": "personal"}
{"query": "from:amazon"} // uses default account
1. gmail_search({"query": "is:unread", "account": "support"})
2. gmail_get({"message_id": "...", "account": "support"})
3. gmail_reply({"message_id": "...", "body": "Thanks for reaching out...", "attachments": ["/abs/path/to/form.pdf"]})
4. gmail_batch_archive({"message_ids": [...]})
To inspect an inbound attachment:
1. gmail_list_attachments({"message_id": "...", "account": "support"})
2. gmail_download_attachment({"message_id": "...", "part_id": "1", "output_dir": "~/Desktop", "account": "support"})
part_id is the stable handle. Gmail mints a new attachment_id on every read, so
two listings of the same message report different attachment_id values for the same
file. Earlier tokens keep working — gmail_download_attachment passes an
attachment_id it does not recognise straight to the Gmail API rather than rejecting
it — but part_id is what you can hold on to and compare. When a message has exactly
one attachment, both selectors can be omitted.
calendar_create_event({
"summary": "Team Standup",
"start_time": "2024-02-05T09:00:00-08:00",
"end_time": "2024-02-05T09:30:00-08:00",
"attendees": ["[email protected]"],
"add_conferencing": true
})
1. docs_create({"title": "Project Report"})
2. docs_append_text({"document_id": "...", "text": "Project Report\n\nIntroduction..."})
3. docs_set_paragraph_style({"document_id": "...", "start_index": 1, "end_index": 15, "named_style_type": "TITLE"})
If you're an AI agent or building integrations, see docs/AGENTS.md for:
These prompts work well with gsuite-mcp:
See INSTALLATION.md for full setup instructions.
Config location: ~/.config/gsuite-mcp/
~/.config/gsuite-mcp/
├── client_secret.json # Your OAuth app credentials
├── config.json # Settings (optional — created by `gsuite-mcp init`)
└── credentials/
└── {email}.json # Per-account tokens
The default OAuth callback port is 38917. Override it in config.json:
{ "oauth_port": 9000 }
Or via environment variable: GSUITE_MCP_OAUTH_PORT=9000
Set GSUITE_OAUTH_TOKEN_CMD to supply OAuth refresh tokens from any external secret source
(password manager, vault, environment injection — any tool that can print a token to stdout).
Contract:
# Example: use any secret-retrieval tool that accepts an account id and prints a token
export GSUITE_OAUTH_TOKEN_CMD="my-secret-tool get-oauth-token"
# gsuite-mcp will call: my-secret-tool get-oauth-token [email protected]
# and use the token printed to stdout as the OAuth refresh token for that account.
When GSUITE_OAUTH_TOKEN_CMD is not set, gsuite-mcp reads tokens from local JSON files
in the credentials directory (default behaviour — unchanged). The env var is process-wide:
all accounts use the hook when it is set.
The hook is secret-manager agnostic. It works with 1Password CLI, HashiCorp Vault,
pass, environment injection, or any other tool that follows the contract above.
Restrict which shared drives are accessible via MCP tools. Add drive_access to config.json:
{
"oauth_port": 38917,
"drive_access": {
"allowed": ["Marketing", "Engineering"]
}
}
Modes (choose one):
"allowed": ["Drive A", "Drive B"] — only these shared drives + My Drive"blocked": ["SENSITIVE", "HR"] — everything except these drivesMy Drive is always accessible. Setting both allowed and blocked is an error. Drives can be specified by name (case-insensitive) or ID. The filter applies to Drive, Docs, and Sheets tools.
When running as an MCP server, gsuite-mcp starts a persistent HTTP server on the OAuth port so agents and users can trigger re-authentication from a browser:
http://localhost:38917/auth — starts OAuth flow (opens Google consent screen)http://localhost:38917/[email protected] — pre-selects the Google accountWhen a tool encounters missing credentials, the error message includes a clickable auth URL. If the port is unavailable, the MCP server continues without the auth endpoint.
go build -o gsuite-mcp ./cmd/gsuite-mcp
go test ./...
go vet ./...
End-to-end tests run against live Google APIs using a dedicated test account. They are excluded from normal go test runs via the e2e build tag.
Setup:
./gsuite-mcp auth [email protected].env in the project root (see e2e/.env.example):
[email protected]
Run:
go test -tags=e2e -v -count=1 ./e2e/...
Tests create temporary artifacts (emails, labels, events, files, task lists) and clean up after themselves. The test account should be a dedicated account, not a production mailbox.
See docs/AGENTS.md for contribution guidelines.
gsuite-mcp uses a patch-first versioning policy — an intentional deviation from strict SemVer:
See RELEASING.md for the full policy, rationale, and release process.
See docs/ROADMAP.md for planned features and development phases.
MIT
Complete Google Workspace MCP server — Gmail, Calendar, Docs, Tasks, Sheets, Contacts, Drive. Single Go binary with multi-account support.
เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Gsuite ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-10-28 Complete Google Workspace MCP server — Gmail, Calendar, Docs, Tasks, Sheets, Contacts, Drive. Single Go binary with multi-account support.