Google Sheets Tools

Overview

Upload CSV files to Google Sheets and download Sheets as CSV. These tools use the same OAuth credentials as the Google Docs tools — see that page for first-time setup if you have not done it yet.

Installation

Included with the gdocs extra:

uv tool install 'claude-code-tools[gdocs]'

Usage

csv2gsheet (Upload)

Upload CSV files to Google Sheets:

# Upload to root of Drive
csv2gsheet data.csv

# Upload to a specific folder
csv2gsheet data.csv --folder "Reports/Data"

# Upload with a custom name
csv2gsheet data.csv --name "Q4 Sales"

# Overwrite if the file already exists
csv2gsheet data.csv --on-existing overwrite

Conflict Handling

Same as md2gdoc:

• ask (default) — prompt for action
• version — auto-add suffix
• overwrite — replace existing file

gsheet2csv (Download)

Download Google Sheets as CSV:

# Download from root
gsheet2csv "My Spreadsheet"

# Download from a specific folder
gsheet2csv "My Spreadsheet" --folder "Reports"

# Save with a custom output name
gsheet2csv "My Spreadsheet" -o data.csv

# Download a specific tab
gsheet2csv "My Spreadsheet" --sheet "Sheet2"

# List spreadsheets in a folder
gsheet2csv --list --folder Reports

# List all tabs in a spreadsheet
gsheet2csv "My Spreadsheet" --list-tabs

Tip

For multi-tab spreadsheets, use --sheet to export a specific tab. The default exports the first tab.

See Also

• Google Docs Tools — upload Markdown as native Google Docs and download Google Docs as Markdown (includes OAuth setup instructions)