recipe-email-drive-link Skill: Share a Drive File and Email the Link

Finds a Google Drive file, shares it with a recipient and emails them the link.

Installs: 31.8K; on skills.sh
Stars: 32K; on GitHub
Updated: Oct 2026; last repo commit

recipe-email-drive-link is a three-step recipe: find a file in Drive, share it with a recipient, then email them the link. It uses the gws program through two service skills, gws-drive and gws-gmail. The example steps share a file as reader with client@example.com and send a message with the link. Both steps reach another person, so check the recipient and role first.

Good for

Anyone who regularly sends clients or colleagues a Drive file
Account managers who share reports and want the email drafted in the same step
Claude Code or Codex users who already run the gws program

Install recipe-email-drive-link

Claude Code

Copy this prompt.

Install the recipe-email-drive-link skill in Claude Code. Run this command:

npx skills add https://github.com/googleworkspace/cli --skill recipe-email-drive-link --skill gws-drive --skill gws-gmail --skill gws-shared -a claude-code

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js, gws installed and signed in.

Do the "First" and "Then" methods once before the skills command: they install gws and sign you in. The skills command adds 4 skills (recipe-email-drive-link, gws-drive, gws-gmail, gws-shared) because recipe-email-drive-link reads gws-shared first and points to the others in the set. Without gcloud, use the manual OAuth setup in the README. To limit what the sign-in grants, run gws auth login -s drive,gmail so the consent screen lists only those services.

From the vendor's docs. Source.

What's in the skill

When it loads

Share a Google Drive file and email the link with a message to recipients.

Sections in SKILL.md

Steps

Key facts

Author: googleworkspace organization (repo owner)
Status: Not an officially supported Google product, per the README
License: Apache-2.0
Installs on skills.sh: 31,777 (Nov 2, 2026)
GitHub stars: 32,038 (Nov 2, 2026) (whole repo)
Last commit: Oct 30, 2026
What installs: 1 file, SKILL.md; it bundles no scripts
Needs: the gws program signed in to Google, plus gws-shared and gws-drive, gws-gmail
skills.sh audits: Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass
Documented setups: skills CLI, OpenClaw, Gemini CLI extension

What it includes

Finds the file by name
The example searches for a file named Quarterly Report.
Network · gws drive files list
Shares the file with a recipient
The example gives the role reader to a user's email address.
Write · gws drive permissions create
Emails the link with a message
Sends a message with the document link to the recipient.
Write · gws gmail +send

From the official docs

Permissions

Medium risk

It changes a file's sharing list and sends email from your account. Sign in with only the services you need and read each command before you approve it.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It changes who can open a file
Step 2 adds a person to the file's sharing list. Check the file, the address and the role before you approve it. github.com
It sends email from your account
Step 3 sends a real message. Check the recipient and the text first. github.com
The project is in active development
The README says to expect breaking changes before v1.0. Re-read the install steps after you update gws. github.com

Technical details

Turning on read-only	No read-only switch in the skill. The gws-shared skill says to prefer --dry-run for destructive operations and to confirm write commands with you.
Talks to	Google Workspace APIs through gws
Sign-in and keys	gws sign-in. The README says credentials are encrypted at rest (AES-256-GCM) with the key kept in your OS keyring.
Scopes	Whatever Google services you grant when you sign in to gws

Questions

What does recipe-email-drive-link do?

Finds a Google Drive file, shares it with a recipient and emails them the link.

How do I install recipe-email-drive-link in Claude Code?

Use the install box above. It adds recipe-email-drive-link together with gws-drive, gws-gmail, gws-shared in one step. You also need the gws program installed and signed in to Google first, and the box lists both steps.

Does recipe-email-drive-link work in the Claude app or Codex?

The install box has a Codex tab that uses the skills CLI's Codex target, but the repo README does not list Codex as a supported setup. The README documents no Claude app route, and every command runs the gws program in a terminal, so use Claude Code or another terminal agent.

Does recipe-email-drive-link need an API key?

No API key. It uses your Google sign-in through gws, and the README says you need a Google Cloud project for the sign-in credentials. gws auth setup can create one if you have the gcloud CLI.

Is recipe-email-drive-link safe?

It changes a file's sharing list and sends email from your account. Check the file, the recipient, the role and the message before you approve each step.

Can it share with someone outside my company?

The example shares with client@example.com, so it can. It adds whatever address you give it, so check the address before you approve.

What do I need to change before running the example?

Replace Quarterly Report, FILE_ID and client@example.com. Step 3 builds the link as https://docs.google.com/document/d/FILE_ID, the Google Docs form, so a Sheet, a PDF or a folder needs its own link. The +send flags are documented in the gws-gmail-send skill, which the install box does not add. It lists --dry-run to show the request without sending and --draft to save a draft instead of sending, both worth asking for on a first run.

Information

updated Nov 2, 2026

Repository: googleworkspace/cli
Folder: skills/recipe-email-drive-link

googleworkspace/cli skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5

googleworkspace/cli README · github.com
skills CLI commands · github.com
recipe-email-drive-link SKILL.md · github.com
gws-shared SKILL.md · github.com
gws-gmail-send SKILL.md · github.com