recipe-save-email-to-doc — Claude Code skill
Saves a Gmail message body to a new Google Doc. Use it when an email needs to be archived or kept as a reference.
npx skills add googleworkspace/cli --skill recipe-save-email-to-doc -a claude-codeWhat recipe-save-email-to-doc does
This skill searches Gmail for a message, retrieves its content, and creates a new Google Doc. The document includes the sender, subject, and email body. The search can use conditions such as a subject and sender address.
It runs gws gmail users messages list, gws gmail users messages get, gws docs documents create, and gws docs +write. The setup requires the gws binary plus the gws-gmail and gws-docs skills. Installations are provided for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode.
Install it when an agent should move selected Gmail messages into Google Docs using a repeatable sequence. A one-off manual copy does not need this skill.
What it helps with
- find a Gmail message by subject and sender
- retrieve message content using
MSG_ID - create a Google Doc for an email archive
- write the sender, subject, and body into the document
Example prompts for the agent
- Find the message with subject `Important Update` from `[email protected]` and save it to a Google Doc.
- Use `gws gmail users messages get` for message `MSG_ID`, then create a document and write the email body into it.
- Save the matching email in a document titled `Saved Email - Important Update`.
How to install recipe-save-email-to-doc
1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill recipe-save-email-to-doc -a claude-code2Manually: put the files in place
~/.claude/skills/recipe-save-email-to-doc/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/recipe-save-email-to-doc/
1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill recipe-save-email-to-doc -a codex2Manually: put the files in place
.agents/skills/recipe-save-email-to-doc/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill recipe-save-email-to-doc -a cursor2Manually: put the files in place
.cursor/skills/recipe-save-email-to-doc/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install googleworkspace/cli recipe-save-email-to-doc2Manually: put the files in place
.github/skills/recipe-save-email-to-doc/SKILL.md1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill recipe-save-email-to-doc -a gemini-cli2Platform CLI
gemini skills install https://github.com/googleworkspace/cli --path skills/recipe-save-email-to-docManually: put the files in place
.devin/skills/recipe-save-email-to-doc/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill recipe-save-email-to-doc -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set95
The whole set →Similar
Questions about recipe-save-email-to-doc
How do I install recipe-save-email-to-doc in Claude Code?
Run npx skills add googleworkspace/cli --skill recipe-save-email-to-doc -a claude-code. The skill file is placed at ~/.claude/skills/recipe-save-email-to-doc/SKILL.md.
What does recipe-save-email-to-doc do?
It searches Gmail, fetches a message body, creates a Google Doc, and writes the email details with the sender and subject.
What does recipe-save-email-to-doc require?
It requires the gws binary and the gws-gmail and gws-docs skills. The listed platforms are Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode.
Source text
SKILL.md · Apache-2.0
---
name: recipe-save-email-to-doc
description: "Save a Gmail message body into a Google Doc for archival or reference."
metadata:
version: 0.22.5
openclaw:
category: "recipe"
domain: "productivity"
requires:
bins:
- gws
skills:
- gws-gmail
- gws-docs
---
# Save a Gmail Message to Google Docs
> **PREREQUISITE:** Load the following skills to execute this recipe: `gws-gmail`, `gws-docs`
Save a Gmail message body into a Google Doc for archival or reference.
## Steps
1. Find the message: `gws gmail users messages list --params '{"userId": "me", "q": "subject:important from:[email protected]"}' --format table`
2. Get message content: `gws gmail users messages get --params '{"userId": "me", "id": "MSG_ID"}'`
3. Create a doc with the content: `gws docs documents create --json '{"title": "Saved Email - Important Update"}'`
4. Write the email body: `gws docs +write --document-id DOC_ID --text 'From: [email protected]
Subject: Important Update
[EMAIL BODY]'`
© googleworkspace · Apache-2.0 · googleworkspace/cli