How to pull job leads from a Gmail label into the career-ops pipeline.
Scanned 9/1/2026
Install to Claude Code
Skills Directorynpx -y skills add career-ops-hq/career-ops --skill gmail --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of Gmail?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/career-ops-hq-gmail)More formats (shields.io, HTML) on the badges page.
---
name: career-ops-plugin-gmail
description: How to pull job leads from a Gmail label into the career-ops pipeline.
license: MIT
---
# gmail plugin
Reads a Gmail label, extracts clean job URLs from authentic (DMARC-passing)
emails, and returns them as leads. The engine writes them to the pipeline.
## Command
- `node plugins.mjs run gmail` — ingest new leads from the configured label.
## Setup
Put `GMAIL_CLIENT_ID` + `GMAIL_CLIENT_SECRET` + `GMAIL_REFRESH_TOKEN` in `.env`
(an OAuth Desktop client + a refresh token from the consent flow). Configure the
label + lookback in `config/plugins.yml`:
```yaml
plugins:
gmail: { enabled: true, label: "Job Leads", days_back: 7 }
```
## Data it produces
`Job[]` ({ title, url, company, location }) — the engine de-dups against the
pipeline and appends new ones. It maintains its own processed-message cursor in
`data/gmail-state.json` to avoid re-reading the same emails.
Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!
