VM0VM0
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

NameTypeDescription
GMAIL_CLIENT_IDvarOAuth client ID
GMAIL_CLIENT_SECRETsecretOAuth client secret
GMAIL_REFRESH_TOKENsecretRefresh token

See Google Cloud Console for how to obtain these credentials. Select the minimum scope required for your use case:

ScopeDescription
https://www.googleapis.com/auth/gmail.readonlyRead emails only
https://www.googleapis.com/auth/gmail.sendSend emails only
https://www.googleapis.com/auth/gmail.composeCreate and send drafts
https://www.googleapis.com/auth/gmail.modifyRead, send, and delete emails

Configuration

vm0.yaml
version: "1.0"

agents:
  my-agent:
    framework: claude-code
    skills:
      - https://github.com/vm0-ai/vm0-skills/tree/main/gmail

Run

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-token

Then 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

AGENTS.md
# 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
AGENTS.md
# 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