🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Gmail Bridge
πŸ¦€ ClawHub

Gmail Bridge

by @spinzerus

Google Workspace Bridge (Gmail, Drive, Sheets, Calendar) via local API at http://127.0.0.1:8787

Versionv1.0.0
Downloads1,094
#legal#communication
TERMINAL
clawhub install gmail-bridge

πŸ“– About This Skill

name: gmail-bridge description: Google Workspace Bridge (Gmail, Drive, Sheets, Calendar) via local API at http://127.0.0.1:8787 homepage: local metadata: {"clawdbot":{"emoji":"πŸ“§","requires":{"bins":["curl","jq"]}}}

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.