Google Workspace (No Cloud Console)

# Google Workspace Access (No Cloud Console!)

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

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

## 主要优势

| 传统方法 | 此技能 | |---------------------|------------| | 创建 Google Cloud 项目 | ❌ 不需要 | | 启用单独的 API | ❌ 不需要 | | 创建 OAuth 凭证 | ❌ 不需要 | | 下载 client_secret.json | ❌ 不需要 | | 配置重定向 URI | ❌ 不需要 | | **只需使用 Google 登录** | ✅ 仅此而已 |

## 设置（已完成）

```bash 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

```bash # Search emails mcporter call --server google-workspace --tool "gmail.search" query="is:unread" maxResults=10

# Get email content mcporter call --server google-workspace --tool "gmail.get" messageId="<id>"

# Send email mcporter call --server google-workspace --tool "gmail.send" to="[email protected]" subject="Hi" body="Hello"

# Create draft mcporter call --server google-workspace --tool "gmail.createDraft" to="[email protected]" subject="Hi" body="Hello" ```

### Calendar

```bash # List calendars mcporter call --server google-workspace --tool "calendar.list"

# List events mcporter call --server google-workspace --tool "calendar.listEvents" calendarId="[email protected]" timeMin="2026-01-27T00:00:00Z" timeMax="2026-01-27T23:59:59Z"

# Create event mcporter call --server google-workspace --tool "calendar.createEvent" calendarId="[email protected]" summary="Meeting" start='{"dateTime":"2026-01-28T10:00:00Z"}' end='{"dateTime":"2026-01-28T11:00:00Z"}'

# Find free time mcporter call --server google-workspace --tool "calendar.findFreeTime" attendees='["[email protected]","[email protected]"]' timeMin="2026-01-28T09:00:00Z" timeMax="2026-01-28T18:00:00Z" duration=30 ```

### Drive

```bash # Search files mcporter call --server google-workspace --tool "drive.search" query="Budget Q3"

# Download file mcporter call --server google-workspace --tool "drive.downloadFile" fileId="<id>" localPath="/tmp/file.pdf" ```

### Docs

```bash # Find docs mcporter call --server google-workspace --tool "docs.find" query="meeting notes"

# Read doc mcporter call --server google-workspace --tool "docs.getText" documentId="<id>"

# Create doc mcporter call --server google-workspace --tool "docs.create" title="New Doc" markdown="# Hello" ```

### Sheets

```bash # Read spreadsheet mcporter call --server google-workspace --tool "sheets.getText" spreadsheetId="<id>"

# Get range mcporter call --server google-workspace --tool "sheets.getRange" spreadsheetId="<id>" range="Sheet1!A1:B10" ```

## 可用工具（共 49 个）

**Auth（授权）：** auth.clear, auth.refreshToken **Docs（文档）：** docs.create, docs.find, docs.getText, docs.insertText, docs.appendText, docs.replaceText, docs.move, docs.extractIdFromUrl **Drive（云端硬盘）：** drive.search, drive.downloadFile, drive.findFolder **Sheets（表格）：** sheets.getText, sheets.getRange, sheets.find, sheets.getMetadata **Slides（幻灯片）：** slides.getText, slides.find, slides.getMetadata **Calendar（日历）：** calendar.list, calendar.listEvents, calendar.getEvent, calendar.createEvent, calendar.updateEvent, calendar.deleteEvent, calendar.findFreeTime, calendar.respondToEvent **Gmail：** gmail.search, gmail.get, gmail.send, gmail.createDraft, gmail.sendDraft, gmail.modify, gmail.listLabels, gmail.downloadAttachment **Chat（聊天）：** chat.listSpaces, chat.findSpaceByName, chat.sendMessage, chat.getMessages, chat.sendDm, chat.findDmByEmail, chat.listThreads, chat.setUpSpace **People（联系人）：** people.getUserProfile, people.getMe **Time（时间）：** time.getCurrentDate, time.getCurrentTime, time.getTimeZone

## 故障排除

### 重新认证 ```bash mcporter call --server google-workspace --tool "auth.clear" ``` 然后运行任何命令以触发重新认证。

### 刷新令牌 ```bash mcporter call --server google-workspace --tool "auth.refreshToken" ```

### 删除凭证 ```bash rm -rf ~/.config/google-workspace-mcp ```