# GoogleDocs

> Read, append, and replace content in Google Docs via OAuth. USE WHEN edit google doc, append to google doc, replace text in google doc, gdoc.py, paste meeting notes into doc, project doc append, write to google doc, batchUpdate. Drive MCP can't edit Docs — this CLI fills that gap.

- **Type:** Skill
- **Install:** `agentstack add skill-cg-shmoop-claude-skills-googledocs`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [cg-shmoop](https://agentstack.voostack.com/s/cg-shmoop)
- **Installs:** 0
- **Category:** [Security](https://agentstack.voostack.com/c/security)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [cg-shmoop](https://github.com/cg-shmoop)
- **Source:** https://github.com/cg-shmoop/claude-skills/tree/main/GoogleDocs

## Install

```sh
agentstack add skill-cg-shmoop-claude-skills-googledocs
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# GoogleDocs skill

`gdoc.py` — OAuth-authenticated CLI for Google Docs. Fills the gap left by the `claude.ai Google Drive` MCP, which can read/copy/create files but cannot edit Doc content.

## Why this exists

The pipeline `transcript → AI parse → append dated meeting section to project Doc` needs to **edit** Docs. The Drive MCP has no edit/append capability. So we use the Google Docs API directly via `documents.batchUpdate`.

## Setup (one-time)

1. Go to https://console.cloud.google.com/apis/credentials in a GCP project you control.
2. Enable the **Google Docs API** for that project (APIs & Services → Library → "Google Docs API" → Enable).
3. Configure the **OAuth consent screen** if not already done. User type: External (or Internal if you're in a Workspace). Add yourself as a test user. Scope: `https://www.googleapis.com/auth/documents`.
4. Create credentials: **OAuth 2.0 Client ID** → application type: **Desktop app** → name it whatever (e.g. "gdoc.py local").
5. Download the JSON. Save it to `~/.gdoc_oauth_client.json`.
6. Run any `gdoc.py` command. A browser tab opens, you consent, the refresh token is cached to `~/.gdoc_token.json`. Subsequent runs are silent.

Override paths with env vars `GDOC_OAUTH_CLIENT` and `GDOC_TOKEN_FILE` if needed.

## Subcommands

```bash
python ~/.claude/skills/GoogleDocs/tools/gdoc.py  [args]
```

| Command | Signature | Purpose |
|---|---|---|
| `get` | `` | Print plain-text content of the Doc |
| `append` | ` --text "..."` or `--file PATH` | Insert text at end of body |
| `append-section` | ` --heading "H2 text" --file PATH` | Append H2 heading + body. **Lines starting with `- ` or `  - ` become bulleted paragraphs**; the dash prefix is stripped and `createParagraphBullets` is applied. |
| `replace-content` | ` --file PATH` | Wipe entire body, insert file content |
| `replace-text` | ` --from "old" --to "new"` | Batch find/replace via `replaceAllText` |
| `delete-section` | ` --heading "H2 text"` | Find an H2 by exact text, delete from there to the next H2 (or EOF). Pair with `append-section` to redo a section. |

Global flag: `--dry-run` prints the `batchUpdate` request JSON without sending.

## Examples

```bash
# Read a Doc
python gdoc.py get 

# Append a meeting-notes section
python gdoc.py append-section  \
  --heading "2026-05-11 | Weekly sync" \
  --file ./meeting-notes.md

# Fix a stale field
python gdoc.py replace-text  --from "Status: blocked" --to "Status: on_track"
```

## Common errors

- **`OAuth client JSON not found`** → finish the GCP setup, save `client_secret.json` to `~/.gdoc_oauth_client.json`.
- **`403 PERMISSION_DENIED`** → your Google account doesn't have edit permission on the Doc, OR the Docs API isn't enabled for the OAuth client's GCP project.
- **`invalid_grant`** → token expired beyond refresh window. Delete `~/.gdoc_token.json` and re-run any command to re-authorize.

## Related

- `~/.claude/skills/GoogleDocs/REFERENCE.md` — Docs API mental model, request shapes, and the bullet-formatting recipe

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [cg-shmoop](https://github.com/cg-shmoop)
- **Source:** [cg-shmoop/claude-skills](https://github.com/cg-shmoop/claude-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-cg-shmoop-claude-skills-googledocs
- Seller: https://agentstack.voostack.com/s/cg-shmoop
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.