google-workspace-convertlisted
Install: claude install-skill mfmezger/ai_agent_dotfiles
# Google Workspace Converter
Convert Google Workspace files (Docs, Sheets, Slides) to Markdown and vice versa.
Uses Google Drive API with service account authentication.
## Supported Formats
| Format | To Markdown | From Markdown |
| -------------------------------- | ----------- | ------------- |
| Google Docs | Yes | Yes |
| Google Sheets | Yes | No |
| Google Slides | Yes | No |
| Google Drawings | Yes | No |
| Uploaded files (PDF, DOCX, etc.) | Yes | - |
## Prerequisites
Environment variables (can be in `.env` file):
- `GOOGLE_APPLICATION_CREDENTIALS` - Path to service account JSON
- `GOOGLE_CLOUD_PROJECT` - GCP project ID
Service account needs:
- Google Drive API enabled in the GCP project
- Files shared with the service account email (use `info` command to get email)
## Commands
### Download: Google Workspace → Markdown
```bash
uvx --with markitdown --with google-auth --with google-api-python-client --with python-dotenv \
python ~/.claude/skills/google-workspace-convert/scripts/convert.py \
to-markdown "GOOGLE_DRIVE_URL_OR_ID"
```
Options:
- `-o, --output PATH` - Output path (default: current dir)
- `--ocr` - Enable OCR for image content
### Upload: Markdown → Google Doc
```bash
uvx --with markitdown --with google-auth --with google-api-python-client --with