A comprehensive Google Workspace integration for managing emails, files, spreadsheets, and calendar events via a local API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install gmail-bridge
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install gmail-bridge using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Gmail Bridge?
The Gmail Bridge skill acts as a localized interface between your AI agent and the entire Google Workspace suite. It enables seamless interaction with Gmail, Google Drive, Google Sheets, and Google Calendar by communicating through a local endpoint at 127.0.0.1. By incorporating this tool into your collection of Openclaw Skills, you can automate complex workflows that involve reading communications, organizing files, and updating schedules without leaving your development environment.
This bridge handles authentication via OAuth tokens and provides a structured way to query data. It is particularly effective for developers who want to integrate real-time workspace data into their automated processes using Openclaw Skills, ensuring that the AI agent has the context it needs to manage your digital workspace efficiently.
Gmail Bridge Use Cases
- Monitoring and summarizing the latest or unread emails for quick updates.
- Searching for specific invoices or project documents within Google Drive using native query syntax.
- Automating data entry or retrieval from Google Sheets ranges for automated reporting.
- Scheduling, listing, and reviewing calendar events for optimized project management.
- Forwarding critical emails to specific addresses as part of an automated Openclaw Skills workflow.
How Gmail Bridge Works
- The AI agent triggers a command via the run.sh script to interact with a specific Google service.
- The script sends a request to a local API bridge running on http://127.0.0.1:8787.
- If the local bridge enforces security, it validates the request using the BRIDGE_SECRET environment variable.
- The bridge utilizes pre-configured OAuth tokens to communicate securely with Google Workspace APIs.
- Structured data is returned to the agent, which then formats the information for the user based on Openclaw Skills behavior rules.
Gmail Bridge Setup
To get started with this skill in your Openclaw Skills library, ensure you have curl and jq installed.
# Set the bridge secret if your local API requires authentication
export BRIDGE_SECRET="your_secret_here"
# Test the connection by listing the 5 most recent emails
bash run.sh recent 5
Gmail Bridge Data Schema & Taxonomy
The skill organizes data based on the Google service being accessed, ensuring clear output for the AI agent.
| Service | Action | Data Organization |
|---|---|---|
| Gmail | Search/List | Returns Subject, From, Date, and Snippet summaries |
| Sheets | Get Range | Provides a 2D array of cell values from specified ranges |
| Drive | File Search | Lists file names and unique Drive IDs |
| Calendar | List Events | Returns chronological event details including location and time |
Gmail Bridge Advanced Features
- Support for advanced Gmail query syntax to filter emails by sender, date, or subject.
- Flexible email detail retrieval with metadata, full, or raw data formats.
- Precise Google Sheets integration allowing for writing complex 2D arrays to specific ranges.
- Seamless event creation in Google Calendar with support for primary and secondary calendars within Openclaw Skills.
- Robust security via local bridge architecture and secret header enforcement.
SKILL.md
Loading
Related Openclaw Skills
VLM Run CLI Agent
Interact with the Orion visual AI agent via CLI to process images, videos, and documents using natural language commands.
Workout Track
A sophisticated logging utility that parses natural language workout data and inserts it into a structured database.
PinchBench Leaderboard
A specialized skill to fetch and analyze real-time LLM benchmark data from the PinchBench leaderboard for agentic coding tasks.
SM Saver
A powerful tool to extract, summarize, and log resources from social media posts and web URLs directly into a structured markdown file.
Base Blockchain Interface
A lightweight interface for querying live onchain data from the Base blockchain without requiring an API key.
Clanker
Automate the deployment of ERC20 tokens on the Base network with integrated Uniswap V4 liquidity pools.
Featured*
