Skip to content

Draft Gmail from Google Doc

Pulls text from a Google Doc and sends it as a Gmail message body via the gws CLI

Stars
32,059
Licence
Apache-2.0
Files
1 file

What it does

This skill gives an AI agent a short recipe for a common office task: reading the text of a Google Doc and using it as the body of an email. It works by calling the gws command-line tool to fetch the document, copy its text, and then send it through Gmail. The skill itself is a set of instructions; the actual reading and sending is done by the gws tool.

Great for

  • Teams who write newsletters or updates in Google Docs and want to email them without copy-pasting
  • Developers who already use the gws CLI and want an agent to automate a routine send
  • People comfortable checking an email before it goes out

Skip it if

  • Sending mail to recipients you have not verified, since the agent sends rather than drafts and mistakes reach real inboxes
  • Documents with sensitive or confidential content, because the text is passed as a command argument and sent over the network to Gmail
  • Anyone without the gws tool installed and authenticated with Google Workspace; the recipe will fail

Try asking

  • “Send my 'Q3 Newsletter' Google Doc to the team list as an email with the subject 'Newsletter Update'”
  • “Take the text of doc ID abc123 and email it to alex@example.com”
  • “Read my meeting notes doc and email the body to the project channel address”
Step-by-step guide: how to use Draft Gmail from Google DocInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the Apache-2.0 licence and an attribution note.

    recipe-draft-email-from-doc.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip recipe-draft-email-from-doc.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip recipe-draft-email-from-doc.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Review the recipient address and subject before letting the agent send, since the skill sends directly rather than saving a draft
  • Keep the email body reasonable in length; the skill passes content as a single command argument, which can break with very long or specially quoted text
  • Confirm the document ID and the body text the agent extracted before sending

What's inside

  • SKILL.md

Redistributed unmodified from googleworkspace/cli under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.