Google Workspace访问（无需云控制台！）

为什么需要这个技能？传统的Google API访问需要在Google Cloud Console中创建项目、启用API、创建OAuth凭据并下载client_secret.json。而这个技能跳过了所有那些步骤。

用途@presto-ai/google-workspace-mcp——只需用你的Google账户登录即可开始。

主要优势

设置（已完成）

npm install -g @presto-ai/google-workspace-mcp
mcporter config add google-workspace --command "npx" --arg "-y" --arg "@presto-ai/google-workspace-mcp" --scope home

首次使用时，它会打开浏览器进行Google OAuth认证。凭据存储在~/.config/google-workspace-mcp/

快捷命令

Gmail

# 搜索邮件
mcporter call --server google-workspace --tool "gmail.search" query="is:unread" maxResults=10

# 获取邮件内容
mcporter call --server google-workspace --tool "gmail.get" messageId="<id>"

# 发送邮件
mcporter call --server google-workspace --tool "gmail.send" to="email@example.com" subject="Hi" body="Hello"

# 创建草稿
mcporter call --server google-workspace --tool "gmail.createDraft" to="email@example.com" subject="Hi" body="Hello"

日历

# 列出日历
mcporter call --server google-workspace --tool "calendar.list"

# 列出事件
mcporter call --server google-workspace --tool "calendar.listEvents" calendarId="your@email.com" timeMin="2026-01-27T00:00:00Z" timeMax="2026-01-27T23:59:59Z"

# 创建事件
mcporter call --server google-workspace --tool "calendar.createEvent" calendarId="your@email.com" summary="Meeting" start='{"dateTime":"2026-01-28T10:00:00Z"}' end='{"dateTime":"2026-01-28T11:00:00Z"}'

# 查找空闲时间
mcporter call --server google-workspace --tool "calendar.findFreeTime" attendees='["a@example.com","b@example.com"]' timeMin="2026-01-28T09:00:00Z" timeMax="2026-01-28T18:00:00Z" duration=30

云端硬盘

# 搜索文件
mcporter call --server google-workspace --tool "drive.search" query="Budget Q3"

# 下载文件
mcporter call --server google-workspace --tool "drive.downloadFile" fileId="<id>" localPath="/tmp/file.pdf"

文档

# 查找文档
mcporter call --server google-workspace --tool "docs.find" query="meeting notes"

# 读取文档
mcporter call --server google-workspace --tool "docs.getText" documentId="<id>"

# 创建文档
mcporter call --server google-workspace --tool "docs.create" title="New Doc" markdown="# Hello"

表格

# 读取电子表格
mcporter call --server google-workspace --tool "sheets.getText" spreadsheetId="<id>"

# 获取范围
mcporter call --server google-workspace --tool "sheets.getRange" spreadsheetId="<id>" range="Sheet1!A1:B10"

可用工具 (共49个)

认证：auth.clear, auth.refreshToken文档：docs.create, docs.find, docs.getText, docs.insertText, docs.appendText, docs.replaceText, docs.move, docs.extractIdFromUrl云端硬盘：drive.search, drive.downloadFile, drive.findFolder表格：sheets.getText, sheets.getRange, sheets.find, sheets.getMetadata幻灯片：slides.getText, slides.find, slides.getMetadata日历：calendar.list, calendar.listEvents, calendar.getEvent, calendar.createEvent, calendar.updateEvent, calendar.deleteEvent, calendar.findFreeTime, calendar.respondToEventGmail：gmail.search, gmail.get, gmail.send, gmail.createDraft, gmail.sendDraft, gmail.modify, gmail.listLabels, gmail.downloadAttachment聊天：chat.listSpaces, chat.findSpaceByName, chat.sendMessage, chat.getMessages, chat.sendDm, chat.findDmByEmail, chat.listThreads, chat.setUpSpace联系人：people.getUserProfile, people.getMe时间：time.getCurrentDate, time.getCurrentTime, time.getTimeZone

故障排除

重新认证

mcporter call --server google-workspace --tool "auth.clear"

然后运行任何命令以触发重新认证。

令牌刷新

mcporter call --server google-workspace --tool "auth.refreshToken"

删除凭据

rm -rf ~/.config/google-workspace-mcp