Skip to content

cli.md

Latest commit

 

History

History
86 lines (65 loc) · 2.93 KB

cli.md

File metadata and controls

86 lines (65 loc) · 2.93 KB

CLI Reference

The mcp-google binary can run as an MCP server or call the same Google Docs, Sheets, and Slides tools directly from the command line.

Discover Commands

mcp-google --help
mcp-google <command> --help

The CLI is generated with Cobra, so --help is the easiest way to reference the current command list and flags.

Server Commands

Command Description
mcp-google Start the MCP server using stdio
mcp-google serve Start the MCP server explicitly
mcp-google version Print version information

Google Docs Commands

Command MCP tool
get-document-metadata <document-id-or-url> get_document_metadata
get-document-content <document-id-or-url> get_document_content
get-document-text <document-id-or-url> get_document_text
get-document-paragraphs <document-id-or-url> get_document_paragraphs

Google Sheets Commands

Command MCP tool
get-spreadsheet-metadata <spreadsheet-id-or-url> get_spreadsheet_metadata
list-sheets <spreadsheet-id-or-url> list_sheets
get-sheet-values <spreadsheet-id-or-url> <range> get_sheet_values
get-sheet-data <spreadsheet-id-or-url> get_sheet_data

Google Slides Commands

Command MCP tool
get-presentation <presentation-id> get_presentation
list-slides <presentation-id> list_slides
get-slide <presentation-id> get_slide
get-slide-notes <presentation-id> get_slide_notes
get-presentation-content <presentation-id> get_presentation_content

Global Flags

Flag Environment variable Description
--credentials GOOGLE_CREDENTIALS_FILE Google service account credentials JSON file
--goauth-credentials-file GOAUTH_CREDENTIALS_FILE goauth CredentialsSet JSON file
--goauth-credentials-account GOAUTH_CREDENTIALS_ACCOUNT Account key in the goauth CredentialsSet
--vault OMNITOKEN_VAULT_URI Vault URI for credentials
--credentials-name OMNITOKEN_CREDENTIALS_NAME Credential name in the vault
-o, --output Output format: json or pretty

Examples

# Google Docs
mcp-google get-document-metadata https://docs.google.com/document/d/abc123/edit \
  --credentials /path/to/service-account.json

mcp-google get-document-content abc123 \
  --include-metadata \
  --include-images \
  --include-tables \
  --include-headers \
  --include-footers \
  -o pretty

# Google Sheets
mcp-google get-spreadsheet-metadata https://docs.google.com/spreadsheets/d/xyz789/edit \
  --credentials /path/to/service-account.json

mcp-google get-sheet-data xyz789 --sheet-name "Sheet1" -o pretty

mcp-google get-sheet-values xyz789 "A1:D10" --value-format typed -o pretty

# Google Slides
mcp-google get-slide presentation123 --index 0 -o pretty