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
• For example: bash run.sh forward 19c647bc33f89bdd christopher.tock@gmail.com

5) Email details:

• bash run.sh get 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 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

Sheets

1) Read a range:

• bash run.sh sheets-get "Sheet1!A1:D20"

2) Write values:

• bash run.sh sheets-set "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.