Skip to content
Back to skills

Gmail Auto Draft

ASecurity

Monitor Gmail inbox, read incoming emails, generate personalized follow-up replies with OpenAI, and save replies into Gmail Drafts for human review. Use when the user wants Gmail auto-monitoring, AI-assisted client email responses, draft-before-send workflows, or agency inbox automation.

  • 3 stars
  • 0 votes
  • 0 copies
  • 5 views
  • Added September 9, 2026
toolspythongobashapibackend

Works with

  • cli
  • api

Security analysis

A96/100
  • mediumInstalls packages at runtime which could introduce malicious dependencies

Pro shows the line behind each finding and how to fix it

Scanned September 9, 2026

npx -y skills add Lord1Egypt/awesome-skill-forge --skill gmail-auto-draft --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Gmail Auto Draft?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Gmail Auto Draft
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/lord1egypt-gmail-auto-draft/badge)](https://www.skillsdirectory.com/skills/lord1egypt-gmail-auto-draft)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: gmail-auto-draft
description: Monitor Gmail inbox, read incoming emails, generate personalized follow-up replies with OpenAI, and save replies into Gmail Drafts for human review. Use when the user wants Gmail auto-monitoring, AI-assisted client email responses, draft-before-send workflows, or agency inbox automation.
---

# Gmail Auto Draft

Use this skill to build or run a review-safe Gmail reply workflow: read new emails, generate AI reply text, and save drafts instead of sending directly.

## Quick workflow

1. Prepare Google OAuth credentials.
2. Use local GMN endpoint (`openclaw:main`) or set external OpenAI key.
3. Run one-shot mode to validate draft creation.
4. Tune query and prompt style.
5. Switch to polling mode for continuous monitoring.

## Run commands

Install dependencies:

```bash
cd skills/gmail-auto-draft/scripts
python3 -m pip install -r requirements.txt
```

Default backend (local GMN via OpenClaw gateway):

```bash
export OPENAI_BASE_URL="http://127.0.0.1:18789/v1"
export OPENAI_MODEL="openclaw:main"
```

Or use OpenAI directly:

```bash
export OPENAI_API_KEY="your_openai_key"
export OPENAI_MODEL="gpt-4o-mini"
```

One-shot test:

```bash
./run_once.sh --auth-mode local --max-emails 3
```

Continuous monitor:

```bash
./run_once.sh --poll-interval 60 --max-emails 5 --mark-read
```

Upwork demo profile (lead-focused query + fixed agency tone):

```bash
./run_upwork_demo.sh --auth-mode local --max-emails 5
```

## Common options

- `--query`: Gmail search filter for target emails.
- `--max-emails`: max messages per cycle.
- `--poll-interval`: seconds between cycles (`0` means run once).
- `--openai-model`: model name (default `openclaw:main`).
- `--openai-base-url`: OpenAI-compatible base URL (default `http://127.0.0.1:18789/v1`).
- `--agency-profile`: business context for OpenAI prompt.
- `--agency-profile-file`: load agency context from a text file.
- `--style-rules`: response style constraints.
- `--style-rules-file`: load style rules from a text file.
- `--query-file`: load Gmail query from a text file.
- `--mark-read`: mark processed messages as read.
- `--processed-label`: label for already drafted emails (default `openclaw_auto_drafted`).

## Output behavior

The script prints JSON for each cycle:
- `processed`: number of drafted replies
- `created_drafts`: draft metadata
- `skipped`: skipped message reasons
- `errors`: per-message errors

## Resources

- Script: `scripts/gmail_auto_draft.py`
- Runner: `scripts/run_once.sh`
- Demo runner: `scripts/run_upwork_demo.sh`
- Dependencies: `scripts/requirements.txt`
- Setup guide: `references/setup.md`
- Prompt/query tuning: `references/prompt-tuning.md`
- Demo config: `references/upwork-demo/agency_profile.txt`
- Demo config: `references/upwork-demo/style_rules.txt`
- Demo config: `references/upwork-demo/gmail_query.txt`

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in tools →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.