Agent Skills › sanjay3290/ai-skills › google-docs

google-docs

GitHub

轻量级 Google Docs 集成技能，支持通过 OAuth 独立认证创建、搜索、读取和编辑文档内容。无需 MCP 服务器，提供便捷的命令行工具以管理 Google Workspace 账号下的文档操作。

skills/google-docs/SKILL.md sanjay3290/ai-skills

Trigger Scenarios

用户请求创建新的 Google 文档用户需要查找或搜索特定标题的文档用户要求读取或获取文档文本内容用户希望向文档添加、插入或替换文本

Install

npx skills add sanjay3290/ai-skills --skill google-docs -g -y

More Options

Use without installing

npx skills use sanjay3290/ai-skills@google-docs

指定 Agent (Claude Code)

npx skills add sanjay3290/ai-skills --skill google-docs -a claude-code -g -y

安装 repo 全部 skill

npx skills add sanjay3290/ai-skills --all -g -y

预览 repo 内 skill

npx skills add sanjay3290/ai-skills --list

SKILL.md

Frontmatter

{
    "name": "google-docs",
    "license": "Apache-2.0",
    "metadata": {
        "author": "sanjay3290",
        "version": "1.0"
    },
    "description": "Interact with Google Docs - create documents, search by title, read content, and edit text.\nUse when user asks to: create a Google Doc, find a document, read doc content, add text to a doc,\nor replace text in a document. Lightweight alternative to full Google Workspace MCP server with\nstandalone OAuth authentication.\n"
}

Google Docs

Lightweight Google Docs integration with standalone OAuth authentication. No MCP server required.

⚠️ Requires Google Workspace account. Personal Gmail accounts are not supported.

First-Time Setup

Authenticate with Google (opens browser):

python scripts/auth.py login

Check authentication status:

python scripts/auth.py status

Logout when needed:

python scripts/auth.py logout

Commands

All operations via scripts/docs.py. Auto-authenticates on first use if not logged in.

# Create a new document
python scripts/docs.py create "Meeting Notes"

# Create a document with initial content
python scripts/docs.py create "Project Plan" --content "# Overview\n\nThis is the project plan."

# Find documents by title
python scripts/docs.py find "meeting" --limit 10

# Get text content of a document
python scripts/docs.py get-text 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms

# Get text using a full URL
python scripts/docs.py get-text "https://docs.google.com/document/d/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms/edit"

# Append text to end of document
python scripts/docs.py append-text 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms "New paragraph at the end."

# Insert text at beginning of document
python scripts/docs.py insert-text 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms "Text at the beginning.\n\n"

# Replace text in document
python scripts/docs.py replace-text 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms "old text" "new text"