google-docs

Google Docs

スタンドアロンの OAuth 認証による軽量な Google Docs 連携です。MCP サーバーは必要ありません。

⚠️ Google Workspace アカウントが必要です。 個人の Gmail アカウントはサポートされていません。

初回セットアップ

Google で認証します（ブラウザーが開きます）：

python scripts/auth.py login

認証状態を確認します：

python scripts/auth.py status

必要に応じてログアウトします：

python scripts/auth.py logout

コマンド

すべての操作は scripts/docs.py を介して行います。ログインしていない場合は、初回使用時に自動認証されます。

# 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"

ドキュメント ID の形式

Google Docs のドキュメント ID は、1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms のような形式です。次の方法で指定できます：

• URL 全体を使用する（ID は自動的に抽出されます）
• ドキュメント ID のみを使用する
• find コマンドの結果からドキュメント ID を取得する

トークン管理

トークンはシステムのキーリングを使用して安全に保存されます：

• macOS：Keychain
• Windows：Windows Credential Locker
• Linux：Secret Service API（GNOME Keyring、KDE Wallet など）

サービス名：google-docs-skill-oauth

アクセストークンの有効期限が切れると、Google のクラウド関数を使用して自動的に更新されます。