gmail-bridge
Use this skill whenever the user asks about:
- - latest emails / unread emails / email search
- reading a specific email
- searching Google Drive files
- reading/writing Google Sheets ranges
- checking calendar events or creating events
IMPORTANT BEHAVIOR RULES (for a good assistant experience)
- - Do NOT return Gmail message IDs alone unless the user explicitly asks.
- For “check my latest email(s)”, return a short list of the latest 5–10 items with:
Subject, From, Date, Snippet
- - If the user asks “open email #3” or similar, call
get on that message ID and summarize. - For Sheets/Drive/Calendar, always show a concise summary and ask a follow-up only when an ID/range/time window is missing.
How to use
Gmail
1) Latest emails (returns summaries):
2) Unread emails:
3) Search emails (Gmail query syntax):
4) Forward an email to a specific address:
- - INLINECODE4
- For example: INLINECODE5
5) Email details:
- - INLINECODE6
- formats:
metadata (default), full, INLINECODE9
Gmail
1) Latest emails (returns summaries):
2) Unread emails:
3) Search emails (Gmail query syntax):
4) Email details:
- - INLINECODE13
- formats:
metadata (default), full, INLINECODE16
Drive
1) Search files (Drive query language):
2) Get file metadata:
Sheets
1) Read a range:
2) Write values:
Calendar
1) List events:
2) Create an event:
Auth / Security
- - This skill calls a local bridge on 127.0.0.1. If the bridge enforces a secret header, set:
export BRIDGE_SECRET="..." before running commands.
- - The bridge uses OAuth tokens stored on the server.
gmail-bridge
当用户询问以下内容时,请使用此技能:
- - 最新邮件/未读邮件/邮件搜索
- 阅读特定邮件
- 搜索Google Drive文件
- 读取/写入Google Sheets范围
- 查看日历事件或创建事件
重要行为规则(为获得良好的助手体验)
- - 除非用户明确要求,否则不要仅返回Gmail消息ID。
- 对于“查看我的最新邮件”,返回最近5-10条项目的简短列表,包含:
主题、发件人、日期、摘要
- - 如果用户要求“打开第3封邮件”或类似内容,请对该消息ID调用get并总结。
- 对于Sheets/Drive/Calendar,始终显示简洁摘要,仅当缺少ID/范围/时间窗口时提出后续问题。
使用方法
Gmail
1) 最新邮件(返回摘要):
2) 未读邮件:
3) 搜索邮件(Gmail查询语法):
- - bash run.sh search from:amazon subject:invoice 10
4) 将邮件转发到指定地址:
- - bash run.sh forward
- 例如:bash run.sh forward 19c647bc33f89bdd christopher.tock@gmail.com
5) 邮件详情:
- - bash run.sh get metadata
- 格式:metadata(默认)、full、raw
Gmail
1) 最新邮件(返回摘要):
2) 未读邮件:
3) 搜索邮件(Gmail查询语法):
- - bash run.sh search from:amazon subject:invoice 10
4) 邮件详情:
- - bash run.sh get metadata
- 格式:metadata(默认)、full、raw
Drive
1) 搜索文件(Drive查询语言):
- - bash run.sh drive-search name contains FutureReady 10
2) 获取文件元数据:
Sheets
1) 读取范围:
- - bash run.sh sheets-get Sheet1!A1:D20
2) 写入值:
- - bash run.sh sheets-set Sheet1!A1:B2 [[\A1\,\B1\],[\A2\,\B2\]]
Calendar
1) 列出事件:
- - bash run.sh cal-events 10 2026-02-01T00:00:00Z 2026-03-01T00:00:00Z primary
2) 创建事件:
- - bash run.sh cal-create Workshop 2026-02-20T02:00:00Z 2026-02-20T03:00:00Z primary Bangi Prep session
认证/安全
- - 此技能调用127.0.0.1上的本地桥接服务。如果桥接服务强制执行密钥头,请在运行命令前设置:
export BRIDGE_SECRET=...