菜单
Read Gmail messages and threads using gws CLI. Use this skill when any Founder OS plugin needs to search, list, or retrieve email messages — replaces Gmail MCP server read operations.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | gmail-read |
| description | Read Gmail messages and threads using gws CLI. Use this skill when any Founder OS plugin needs to search, list, or retrieve email messages — replaces Gmail MCP server read operations. |
Gmail read operations via gws CLI. Covers searching, listing, and retrieving messages and threads.
gmail.readonly (minimum), gmail.insert for triage# Get unread messages with smart categorization
gws gmail +triage --max 50 --format json
Output: JSON array of messages with id, subject, from, date, snippet, labels.
This is the fastest way to get an inbox overview. Use for P01 Inbox Zero, P02 Daily Briefing, P22 Morning Sync.
# Custom Gmail search query
gws gmail users messages list --params '{"userId":"me","q":"QUERY","maxResults":N}' --format json
Query syntax (same as Gmail search box):
is:unread — unread messagesfrom:user@example.com — from specific senderafter:2026/03/01 before:2026/03/09 — date rangesubject:invoice — subject contains wordhas:attachment — has attachmentslabel:important — specific labelOROutput: JSON with messages array containing {id, threadId} pairs. You need a separate get call for full message content.
# Get complete message with headers and body
gws gmail users messages get --params '{"userId":"me","id":"MSG_ID","format":"full"}' --format json
Output: Full message object with:
payload.headers[] — Subject, From, To, Date, etc.payload.body.data — Base64-encoded body (for simple messages)payload.parts[] — MIME parts (for multipart messages)labelIds[] — Applied labelssnippet — Plain text preview# Get full thread (all messages in conversation)
gws gmail users threads get --params '{"userId":"me","id":"THREAD_ID","format":"full"}' --format json
gws gmail users labels list --params '{"userId":"me"}' --format json
# Step 1: Get message IDs
ids=$(gws gmail users messages list --params '{"userId":"me","q":"is:unread","maxResults":20}' --format json | jq -r '.messages[].id')
# Step 2: Get each message
for id in $ids; do
gws gmail users messages get --params "{\"userId\":\"me\",\"id\":\"$id\",\"format\":\"full\"}" --format json
done
gws gmail users messages list --params '{"userId":"me","q":"from:client@example.com after:2026/03/01","maxResults":10}' --format json
If Gmail is unavailable, return:
{"source": "gmail", "status": "unavailable", "reason": "gws CLI not found or auth expired"}
Continue with other data sources. Never hard-fail a plugin because Gmail is unreachable.
Scans Founder OS plugin deployment, scores coverage by business area, and produces an actionable automation scorecard. Used by /audit:scan and /audit:report commands.
Loads structured business context files into plugin execution context. Activates at the start of any plugin command to provide business knowledge, current strategy, and operational data. Plugins inline the loading logic directly (same pattern as gws CLI usage).
Read Google Calendar events and check availability using gws CLI. Use this skill when any Founder OS plugin needs to list events, check schedules, or query free/busy status — replaces Google Calendar MCP server read operations.
Create, update, and delete Google Calendar events using gws CLI. Use this skill when any Founder OS plugin needs to modify calendar events — replaces Google Calendar MCP server write operations.
Search, list, and retrieve Google Drive files using gws CLI. Use this skill when any Founder OS plugin needs to find, read, or export Drive files — replaces Google Drive MCP server read operations.
Upload, create, and update Google Drive files using gws CLI. Use this skill when any Founder OS plugin needs to write files to Drive — replaces Google Drive MCP server write operations.