recipe-save-email-to-doc

Saves a Gmail message body into a Google Doc using the gws CLI.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill recipe-save-email-to-doc-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: recipe-save-email-to-doc
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/recipe-save-email-to-doc
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill recipe-save-email-to-doc-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Archiving important emails outside the inbox usually means manual copy-pasting into documents. This recipe automates moving a Gmail message body into a Google Doc for long-term archival or reference. ## Core Features & Use Cases - Gmail Search and Retrieval: Finds messages by query (e.g., subject and sender filters) and fetches full message content via the Gmail API. - Google Doc Creation and Writing: Creates a new Google Doc and writes the email body, sender, and subject into it. - Use Case: You receive a critical project update from your manager and want a permanent, shareable record. Run this recipe to locate the email and archive its full content into a titled Google Doc. ## Quick Start Save the email from my boss with the subject Important Update into a new Google Doc.

Frequently Asked Questions about recipe-save-email-to-doc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I save a Gmail email to a Google Doc?

Use the gws CLI to find the message with gmail users messages list, retrieve its content with messages get, then create a Google Doc and write the email body into it using docs documents create and docs +write.

How do I search Gmail messages by sender and subject?

Pass a query string in the q parameter, such as subject:important from:[email protected], to the gws gmail users messages list command. The results return message IDs you can use to fetch full content.

What tools are required to archive emails to Google Docs?

You need the gws command-line tool installed, plus the gws-gmail and gws-docs skills loaded. These provide access to the Gmail and Google Docs APIs used in each step.

Can I save multiple emails into one Google Doc?

The recipe creates one document per run, but you can repeat the docs +write step with the same document ID to append additional email bodies into a single Google Doc.

Why does the Gmail message search return no results?

Empty results usually mean the query syntax does not match any message, such as a misspelled sender address or subject. Verify the q parameter values and confirm the message exists in the authenticated account.