gmail-bridge

# 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): - `bash run.sh recent 10` 2) Unread emails: - `bash run.sh unread 10` 3) Search emails (Gmail query syntax): - `bash run.sh search "from:amazon subject:invoice" 10` 4) Forward an email to a specific address: - `bash run.sh forward <messageId> <emailAddress>` - For example: `bash run.sh forward 19c647bc33f89bdd christopher.tock@gmail.com` 5) Email details: - `bash run.sh get <messageId> metadata` - formats: `metadata` (default), `full`, `raw` ### Gmail 1) Latest emails (returns summaries): - `bash run.sh recent 10` 2) Unread emails: - `bash run.sh unread 10` 3) Search emails (Gmail query syntax): - `bash run.sh search "from:amazon subject:invoice" 10` 4) Email details: - `bash run.sh get <messageId> metadata` - formats: `metadata` (default), `full`, `raw` ### Drive 1) Search files (Drive query language): - `bash run.sh drive-search "name contains 'FutureReady'" 10` 2) Get file metadata: - `bash run.sh drive-file <fileId>` ### Sheets 1) Read a range: - `bash run.sh sheets-get <spreadsheetId> "Sheet1!A1:D20"` 2) Write values: - `bash run.sh sheets-set <spreadsheetId> "Sheet1!A1:B2" '[[\"A1\",\"B1\"],[\"A2\",\"B2\"]]'` ### Calendar 1) List events: - `bash run.sh cal-events 10 2026-02-01T00:00:00Z 2026-03-01T00:00:00Z primary` 2) Create an event: - `bash run.sh cal-create "Workshop" 2026-02-20T02:00:00Z 2026-02-20T03:00:00Z primary "Bangi" "Prep session"` ## 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.