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 [email protected]

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.