Disponibilidade de Material de Apoio

Esta cópia do catálogo contém as orientações embutidas abaixo, mas não inclui os seguintes caminhos de suporte. Eles são pré-requisitos externos, não arquivos empacotados:

• <support-root>/scripts/auth.py
• <support-root>/scripts/drive.py

Solicite o material de apoio original ou uma instalação existente antes de usar uma etapa que dependa desses caminhos; este catálogo não identifica uma fonte de download verificada para eles. Resolva cada caminho em relação a essa instalação, inspecione seu conteúdo e verifique quaisquer licenças aplicáveis e pré-requisitos de execução. Não execute um comando ou afirme que um procedimento referenciado foi seguido até que seu arquivo necessário exista. Não fabrique os scripts ausentes nem trate um arquivo não relacionado com o mesmo nome como equivalente. Etapas independentes totalmente documentadas aqui podem prosseguir dentro do escopo autorizado do usuário; relate qualquer etapa dependente como indisponível.

Google Drive

Integração leve com o Google Drive com autenticação OAuth independente. Nenhum servidor MCP é necessário. Acesso total de leitura/escrita.

Requer conta do Google Workspace. Contas pessoais do Gmail não são suportadas.

Quando Usar

• Você precisa pesquisar, listar, fazer upload, download, mover ou organizar arquivos e pastas do Google Drive.
• A tarefa requer automação direta de leitura/escrita do Drive por meio de scripts locais em uma conta do Workspace.
• Você deseja operações de Drive em nível de arquivo sem introduzir uma dependência de servidor MCP.

Configuração Inicial

Autentique-se com o Google (abre o navegador):

python scripts/auth.py login

Verifique o status da autenticação:

python scripts/auth.py status

Faça logout quando necessário:

python scripts/auth.py logout

Comandos de Leitura

Todas as operações via scripts/drive.py. Autentica automaticamente no primeiro uso se não estiver logado.

# Search for files (full-text search)
python scripts/drive.py search "quarterly report"

# Search by title only
python scripts/drive.py search "title:budget"

# Search using Google Drive URL (extracts ID automatically)
python scripts/drive.py search "https://drive.google.com/drive/folders/1ABC123..."

# Search files shared with you
python scripts/drive.py search --shared-with-me

# Search with pagination
python scripts/drive.py search "report" --limit 5 --page-token "..."

# Find a folder by exact name
python scripts/drive.py find-folder "Project Documents"

# List files in root Drive
python scripts/drive.py list

# List files in a specific folder
python scripts/drive.py list 1ABC123xyz --limit 20

# Download a file
python scripts/drive.py download 1ABC123xyz ./downloads/report.pdf

Comandos de Escrita

# Upload a file to Drive root
python scripts/drive.py upload ~/Documents/report.pdf

# Upload to a specific folder
python scripts/drive.py upload ~/Documents/report.pdf --folder 1ABC123xyz

# Upload with a custom name
python scripts/drive.py upload ~/Documents/report.pdf --name "Q4 Report.pdf"

# Create a new folder
python scripts/drive.py create-folder "Project Documents"

# Create a folder inside another folder
python scripts/drive.py create-folder "Attachments" --parent 1ABC123xyz

# Move a file to a different folder
python scripts/drive.py move FILE_ID DESTINATION_FOLDER_ID

# Copy a file
python scripts/drive.py copy FILE_ID
python scripts/drive.py copy FILE_ID --name "Report Copy" --folder 1ABC123xyz

# Rename a file or folder
python scripts/drive.py rename FILE_ID "New Name.pdf"

# Move a file to trash
python scripts/drive.py trash FILE_ID

Formatos de Consulta de Pesquisa

O comando de pesquisa suporta vários formatos de consulta:

Formato de ID de Arquivo

O Google Drive usa IDs longos como 1ABC123xyz_-abc123. Obtenha IDs de:

• Resultados de search
• Resultados de find-folder
• Resultados de list
• URLs do Google Drive

Limitações de Download

• Arquivos regulares (PDFs, imagens, etc.) são baixados diretamente
• Documentos/Planilhas/Apresentações do Google não podem ser baixados por meio desta ferramenta
• Para arquivos do Google Workspace, use exportação ou ferramentas dedicadas

Gerenciamento de Tokens

Tokens armazenados com segurança usando o gerenciador de senhas do sistema:

• macOS: Keychain
• Windows: Credential Locker do Windows

…