Agent Skills
Gmail
Send and manage emails with Gmail API
Gmail is Google's email service. This skill enables your agent to send emails, read messages, and manage your inbox.
Required Environment
| Name | Type | Description |
|---|---|---|
GMAIL_CLIENT_ID | var | OAuth client ID |
GMAIL_CLIENT_SECRET | secret | OAuth client secret |
GMAIL_REFRESH_TOKEN | secret | Refresh token |
See Google Cloud Console for how to obtain these credentials. Select the minimum scope required for your use case:
| Scope | Description |
|---|---|
https://www.googleapis.com/auth/gmail.readonly | Read emails only |
https://www.googleapis.com/auth/gmail.send | Send emails only |
https://www.googleapis.com/auth/gmail.compose | Create and send drafts |
https://www.googleapis.com/auth/gmail.modify | Read, send, and delete emails |
Configuration
version: "1.0"
agents:
my-agent:
framework: claude-code
skills:
- https://github.com/vm0-ai/vm0-skills/tree/main/gmailRun
Store your secrets on the platform (recommended, one-time setup):
vm0 secret set GMAIL_CLIENT_SECRET your-gmail-client-secret
vm0 secret set GMAIL_REFRESH_TOKEN your-gmail-refresh-tokenThen run your agent - secrets are automatically loaded:
vm0 run my-agent "check my inbox"For CI/CD or temporary overrides, pass secrets at runtime: --secrets GMAIL_CLIENT_SECRET=value. See Environment Variables for details.
Example Instructions
# Email Digest Agent
You use Gmail to create daily email digests.
## Workflow
1. Fetch unread emails from the past 24 hours
2. Categorize by sender and topic
3. Create a summary digest
4. Send the digest to the user
## Categories
- Urgent: from VIP senders
- Newsletters: from subscribed lists
- Notifications: automated emails
- Personal: everything else# Customer Response Agent
You use Gmail to draft customer email responses.
## Workflow
1. Read incoming customer emails
2. Analyze the question or issue
3. Draft a professional response
4. Save as draft for review
## Tone
- Professional and friendly
- Clear and concise
- Include next steps when applicable