gmail

Files (3)

• README.md
• SKILL.md
• config.json.example

SKILL.md (first lines)

## Overview

Gmail skill providing CLI-based email operations via IMAP (fetch/read/search) and SMTP (send). All credentials are retrieved securely from the Secrets Manager.

## Capabilities

| Action | Command | Description |
|--------|---------|-------------|
| Fetch | `fetch` | List recent emails with subjects and senders |
| Read | `read <email_id>` | Retrieve full body of a specific email |
| Send | `send` | Send an email via SMTP |
| Search | `search <query>` | Search for emails based on a query |
| Mark Read | `mark_read <email_id>` | Mark an email as read |

## Prerequisites

### Gmail Account Setup

1. **Enable IMAP/SMTP** in Gmail settings:
   - Go to Gmail Settings → Forwarding and POP/IMAP
   - Enable "IMAP Access"

2. **Use App Password** (if 2FA is enabled):
   - Go to Google Account → Security → 2-Step Verification → App passwords
   - Generate a new app password for "Mail"
   - Store this password in Secrets Manager (see below)

### Secrets Manager Setup

Add your Gmail credentials to the Secrets Manager:

```bash
# Add Gmail password (app password recommended)
MJ_MASTER_KEY="0FtgOuPNJTpXMaKseQqUwbInx9RQ402yGqIEsIdJbKs=" \
  node /root/.openclaw/workspace/secrets/add-secret.js \
  gmail password "YOUR_GMAIL_APP_PASSWORD" "Gmail IMAP/SMTP access"
```

**Secret Key Format:** `gmail:password`

## Usage

### Fetch Recent Emails

List the 10 most recent emails:

```bash
python3 /root/.openclaw/workspace/skills/gmail/gmail_tool.py fetch
```

With custom count:

```bash
python3 /root/.openclaw/workspace/skills/gmail/gmail_tool.py fetch --count 25
```

Output includes:
- Email ID (for read/mark_read operations)
- Subject
- Sender
- Date
- Read/unread status

### Read Email

Read a specific email by ID:

```bash
python3 /root/.openclaw/workspace/skills/gmail/gmail_tool.py read <email_id>
```

Example:
```bash
python3 /root/.openclaw/workspace/skills/gmail/gmail_tool.py read 12345
```

Output includes:
- Full headers (From, To, Subject, Date)
- Email body (plain text or HTML)
- Attachments list (if any)

### Send Email

Send an email via SMTP:

```bash
python3 /root/.openclaw/workspace/skills/gmail/gmail_tool.py send \
  --to recipient@example.com \
  --subject "Your Subject" \
  --body "Email body text" \
  --cc optional@example.com \
  --bcc another@example.com
```

**Required flags:** `--to`, `--subject`, `--body`

**Optional flags:** `--cc`, `--bcc`, `--attachments` (comma-separated paths)

### Search Emails

Search for emails using Gmail's search syntax:

```bash
python3 /root/.openclaw/workspace/skills/gmail/gmail_tool.py search "from:boss@example.com"
```

Common search queries:
- `from:email@example.com` - Emails from specific sender
- `to:email@example.com` - Emails sent to specific recipient
- `subject:keyword` - Emails with keyword in subject
- `has:attachment` - Emails with attachments
- `is:unread` - Unread emails only
- `after:2024/01/01` - Emails after a date
- `before:2024/12/31` - Emails before a date
- `label:important` - Emails with specific label

With custom count:
```bash
python3 /root/.openclaw/workspace/skills/gmail/gmail_tool.py search "project update" --count 20

From TylerGarlick/abraxas, MIT.

More from TylerGarlick/abraxas