gcmd

Export Google Docs to Markdown and Sheets to CSV from the command line.

7|1|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/benthomasson/shared-understanding --skill gcmd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gcmd
Source: https://github.com/benthomasson/shared-understanding/tree/main/skills/gcmd
Command: npx skills add https://github.com/benthomasson/shared-understanding --skill gcmd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables you to export and access Google Drive content (docs, sheets, meeting notes) directly from the command line, turning cloud assets into portable, readable formats and enabling automation in your workflows.

Core Features & Use Cases

  • Export Docs as Markdown: Convert Google Docs to Markdown for processing, archiving, or documentation pipelines.
  • Export Sheets as CSV: Output each sheet as separate CSV files for data analysis and reporting.
  • File Discovery & Inspection: List files, search by query, and view detailed metadata and permissions to inform downstream decisions.
  • Workflow Automation: Integrate exports and metadata lookups into batch jobs, notes repositories, or knowledge bases.

Quick Start

Use the gcmd skill to quickly export a Google Doc to Markdown and a Sheet to CSV, then inspect results:

  • Export a Google Doc as Markdown: uvx --from "git+https://github.com/shanemcd/gcmd" gcmd export "https://docs.google.com/document/d/FILE_ID/edit" -o /tmp/
  • Export a Google Sheet as CSV (one file per sheet): uvx --from "git+https://github.com/shanemcd/gcmd" gcmd export "https://docs.google.com/spreadsheets/d/FILE_ID/edit" -o /tmp/
  • List recent files: uvx --from "git+https://github.com/shanemcd/gcmd" gcmd list
  • View details for a file: uvx --from "git+https://github.com/shanemcd/gcmd" gcmd info -v "https://docs.google.com/document/d/FILE_ID/edit"

Frequently Asked Questions about gcmd

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I export Google Docs to Markdown from the command line?

You can export Google Docs to Markdown from the command line using the gcmd tool via uvx. It converts cloud documents into portable Markdown formats suitable for processing, archiving, or documentation pipelines.

Can I export Google Sheets as CSV files using a CLI?

Yes, you can export Google Sheets as CSV files using the command line. The tool outputs each individual sheet as a separate CSV file, enabling straightforward data analysis and reporting.

How do I list and search Google Drive files via the command line?

You can list and search Google Drive files via the command line to perform file discovery. The tool allows you to list recent files, search by query, and view detailed metadata and permissions to inform downstream decisions.

Do I need OAuth credentials to access Google Drive content via CLI?

Yes, you need OAuth credentials for Google Drive APIs to access Google Drive content via CLI. The tool requires these authentication credentials and permission to access your Drive content for exports and metadata retrieval.

What is the best way to automate Google Drive file exports for a knowledge base?

The best way to automate Google Drive file exports for a knowledge base is using a CLI tool like gcmd via uvx. It integrates exports and metadata lookups into batch jobs, notes repositories, or knowledge base workflows.

Does the gcmd tool work without installing dependencies manually?

The gcmd tool runs via uvx, which handles the execution environment automatically without manual dependency installation. You simply run the uvx command with the repository URL to export files or list metadata.