Gmail
Gmail API integration with managed OAuth. Read, send, and manage emails, threads, labels, and drafts. Use this skill when users want to interact with Gmail.... Skill: Gmail Owner: byungkyu Summary: Gmail API integration with managed OAuth. Read, send, and manage emails, threads, labels, and drafts. Use this skill when users want to interact with Gmail.... Tags: latest:1.0.8 Version history: v1.0.8 | 2026-05-07T10:03:31.420Z | user - Added CLI usage examples throughout documentation for common Gmail operations. - Included installation instructions for Maton CLI via NPM and H
Rank
62
Safety
84
Downloads
34k
Updated
May 14, 2026
Version
1.0.8
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 34.3K downloads reported by the source. Last updated 5/14/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Adoption signal
- 34.3K downloadsadoption · observed May 14, 2026
- Vendor
- Clawhubvendor · observed May 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed May 11, 2026
- Adoption signal
- 33.8K downloadsadoption · observed May 11, 2026
- Latest release
- 1.0.8release · observed May 7, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s174c3s2kc1ehqj1ytzntezj2983e2aj:gmail- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-byungkyu-gmail-2/snapshot"
Documentation
CLAWHUB
89,374 characters of source documentation, loaded on request.
Extracted files
2 files captured from the source.
SKILL.md
---
name: gmail
description: |
Gmail API integration with managed OAuth. Read, send, and manage emails, threads, labels, and drafts. Use this skill when users want to interact with Gmail. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
compatibility: Requires network access and valid Maton API key
metadata:
author: maton
version: "1.0"
clawdbot:
emoji: 🧠
requires:
env:
- MATON_API_KEY
---
# Gmail
Access the Gmail API with managed OAuth authentication. Read, send, and manage emails, threads, labels, and drafts.
## Quick Start
**CLI:**
```bash
maton google-mail message list -L 10
```
```bash
maton api '/google-mail/gmail/v1/users/me/messages?maxResults=10'
```
**Python:**
```bash
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/google-mail/gmail/v1/users/me/messages?maxResults=10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
```
## Base URL
```
https://api.maton.ai/google-mail/{native-api-path}
```
Maton proxies requests to `gmail.googleapis.com` and automatically injects your OAuth token.
## Installation
**NPM:**
```bash
npm install -g @maton-ai/cli
```
**Homebrew:**
```bash
brew install maton-ai/cli/maton
```
## Authentication
**CLI:**
```bash
maton login # Opens browser for API key
maton login --interactive # Skip browser, paste API key directly
maton whoami # Show current auth state
```
**Manual:**
1. Sign in or create an account at [maton.ai](https://maton.ai)
2. Go to [maton.ai/settings](https://maton.ai/settings)
3. Copy your API key
4. Set your API key as `MATON_API_KEY`:
```bash
export MATON_API_KEY="YOUR_API_KEY"
```
## Connection Management
Manage your Google OAuth connections at `https://api.maton.ai`.
### List Connections
**CLI:**
```bash
maton connection list google-mail --status ACTIVE
```
```bash
maton api -X GET /connections -f app=google-mail -f status=ACTIVE
```
**Python:**
```bash
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections?app=google-mail&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
```
### Create Connection
**CLI:**
```bash
maton connection create google-mail
```
```bash
maton api /connections -f app=google-mail
```
**Python:**
```bash
python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'google-mail'}).encode()
req = urllib.request.Request('https://api.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
```
### Get Conn_meta.json
{
"ownerId": "kn75240wq8bnv2qm2xgry748jd80b9r0",
"slug": "gmail",
"version": "1.0.8",
"publishedAt": 1778148211420
}AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "34.3K downloads",
"href": "https://clawhub.ai/byungkyu/gmail",
"sourceUrl": "https://clawhub.ai/byungkyu/gmail",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-05-14T06:29:33.558Z",
"isPublic": true
},
{
"factKey": "vendor",
"label": "Vendor",
"value": "Clawhub",
"category": "vendor",
"href": "https://clawhub.ai/byungkyu/gmail",
"sourceUrl": "https://clawhub.ai/byungkyu/gmail",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-05-11T06:25:04.724Z",
"isPublic": true,
"metadata": {}
},
{
"factKey": "protocols",
"label": "Protocol compatibility",
"value": "OpenClaw",
"category": "compatibility",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-byungkyu-gmail-2/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-byungkyu-gmail-2/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-05-11T06:25:04.724Z",
"isPublic": true,
"metadata": {}
},
{
"factKey": "traction",
"label": "Adoption signal",
"value": "33.8K downloads",
"category": "adoption",
"href": "https://clawhub.ai/byungkyu/gmail",
"sourceUrl": "https://clawhub.ai/byungkyu/gmail",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-05-11T06:25:04.724Z",
"isPublic": true,
"metadata": {}
},
{
"factKey": "latest_release",
"label": "Latest release",
"value": "1.0.8",
"category": "release",
"href": "https://clawhub.ai/byungkyu/gmail",
"sourceUrl": "https://clawhub.ai/byungkyu/gmail",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-07T10:03:31.420Z",
"isPublic": true,
"metadata": {}
},
{
"factKey": "handshake_status",
"label": "Handshake status",
"value": "UNKNOWN",
"category": "security",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-byungkyu-gmail-2/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-byungkyu-gmail-2/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true,
"metadata": {}
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.8",
"description": "- Added CLI usage examples throughout documentation for common Gmail operations. - Included installation instructions for Maton CLI via NPM and Homebrew. - Expanded Quick Start and Connection Management sections to cover both CLI and Python methods. - Added specific CLI commands for sending, replying, and forwarding messages, as well as label and thread management. - Improved organization and clarity for multi-connection scenarios and authentication steps.",
"href": "https://clawhub.ai/byungkyu/gmail",
"sourceUrl": "https://clawhub.ai/byungkyu/gmail",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-07T10:03:31.420Z",
"isPublic": true,
"metadata": {}
}
]
}Record generated Oct 10, 2026.
