solo-gmail-cli SKILL.md skillB
solo-gmail-cli from fortunto2/solo-factory is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add fortunto2/solo-factory/solo-gmail-cli@v1.0.0Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- B, 16 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- fortunto2/solo-factory
- Path
skills/gmail-cli/SKILL.md- Versions recorded
- 1
- Latest version
- v1.0.0, committed Nov 8, 2026
- Size
- 7,498 bytes
- Repository stars
- 18
- License
- MIT
Give a coding agent read access to one or several Gmail or Google Workspace mailboxes from the terminal with the `gws` CLI — install it, create the Google Cloud OAuth client, set up one config directory and one wrapper per mailbox, log in read-only, search and read mail, and fix the weekly `invalid_grant`. Use when user says "connect Gmail", "read my mail from the terminal", "search my inbox", "find the email about", "several mailboxes", "set up gws", "gws auth login", "invalid_grant…
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# gmail-cli — Gmail for a coding agent, one wrapper per mailbox `gws` (npm `@googleworkspace/cli`, v0.22.5 verified) calls the Gmail API with your own OAuth client. The mailbox is picked by the env var `GOOGLE_WORKSPACE_CLI_CONFIG_DIR`; there is no `--account` flag, and `userId` of another address gives "Delegation denied". So: one config directory and one wrapper script per mailbox. Full write-up: https://rustman.org/wiki/gmail-cli-several-mailboxes-gws/ Placeholders below: `you@example.com`, `gws-personal`, `gws-work`, `~/.config/gws-personal`. Substitute the user's real names. ## Who does what | Step | Who | |------|-----| | Install, config dirs, wrappers, search, read | agent | | Create Cloud project, enable Gmail API, Branding, Desktop client, download JSON, Publish app | **human, in the browser** (the API cannot create a Desktop client) | | `auth login` (opens a browser, picks the account) | **human**: ask them to run `! gws-personal auth login --readonly` | ## Workflow 1. **Install.** `command -v gws || npm install -g @googleworkspace/cli`; then `gws --version`. Do not upgrade mid-task: 0.4.x to 0.22.x moved the token into the keyring and old caches stop working. …
Read the whole file at its exact version.
How to install
mdr add fortunto2/solo-factory/solo-gmail-cli@sha256:51d0d85567cdbaaaThe line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_2czbgzcesskijhs3)
0 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Nov 8, 2026.
Audit of the latest version
- fail: No recursive delete of root, home or parent (matched: rm -rf ~/)
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (7498 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.
Source
fortunto2/solo-factory · 18 stars · license MIT · pushed 2026-11-08 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_2czbgzcesskijhs3 GET https://markdownregistry.com/api/v1/resolve?ref=fortunto2/solo-factory/solo-gmail-cli GET https://markdownregistry.com/api/v1/blob/51d0d85567cdbaaa9c3e836d6a5a2aba9652ca52d3bc3778dbdd8a72b9a68ad5
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.