Como Conectar o Google Drive ao Claude Code (Windows, Mac, Android e iPhone)

Imagina que o Claude Code é um assistente super inteligente dentro do seu escritório. Agora imagina que todos os seus documentos importantes estão guardados em um armário trancado chamado Google Drive. Para o Claude te ajudar de verdade, ele precisa de uma chave para acessar esse armário.

Este guia ensina como dar essa chave para o Claude — de forma segura, passo a passo.

IMG_OPERATIONAL

GRID_MODE_ON

O que significa "conectar" o Drive ao Claude

Quando você conecta o Google Drive ao Claude Code, ele passa a conseguir:

• Ler documentos do seu Drive (Google Docs, planilhas, PDFs, etc.)
• Listar arquivos e pastas
• Criar e editar documentos
• Buscar informações dentro dos seus arquivos

Isso é feito através de um sistema chamado MCP (Model Context Protocol) — é basicamente um "tradutor" que deixa o Claude conversar com serviços externos como o Google Drive.

O que você precisa antes de começar:

• Claude Code instalado (veja o guia de instalação se ainda não tem)
• Uma conta Google com o Drive ativado
• Node.js instalado no computador
• Cerca de 20 minutos

Entendendo o processo (de forma simples)

Antes de começar, entenda o que vai acontecer:

1. Você cria um "projeto" no Google Cloud (é gratuito para uso pessoal)
2. Dentro desse projeto, você ativa a API do Google Drive
3. Você baixa uma "credencial" — um arquivo que funciona como a chave do armário
4. Você diz para o Claude Code onde essa chave está
5. O Claude consegue acessar o Drive com sua permissão

Parece complicado, mas vamos fazer juntos, passo a passo.

Parte 1 — Criar credenciais no Google Cloud

Esse processo é igual para Windows e Mac. Pode ser feito também pelo celular (Android/iPhone), mas é mais fácil no computador.

Passo 1 — Acesse o Google Cloud Console

IMG_OPERATIONAL

GRID_MODE_ON

1. Vai para https://console.cloud.google.com
2. Faz login com sua conta Google (a mesma que tem o Drive)
3. Se for a primeira vez, vai aparecer uma tela de boas-vindas — aceita os termos

Passo 2 — Crie um novo projeto

1. No canto superior esquerdo, clica em "Selecionar projeto" (ou no nome do projeto atual)
2. Clica em "Novo projeto"
3. Dá um nome para o projeto, tipo: meu-claude-drive
4. Clica em "Criar"
5. Aguarda alguns segundos até o projeto ser criado
6. Seleciona o projeto que você acabou de criar

Passo 3 — Ative a API do Google Drive

IMG_OPERATIONAL

GRID_MODE_ON

1. No menu lateral, procura por "APIs e serviços" → "Biblioteca"
2. Na barra de pesquisa, digita: Google Drive API
3. Clica no resultado "Google Drive API"
4. Clica no botão "Ativar"
5. Aguarda a ativação (uns 10 segundos)

Passo 4 — Crie as credenciais OAuth

1. Volta para "APIs e serviços" → "Credenciais"
2. Clica em "+ Criar credenciais" → "ID do cliente OAuth"
3. Se aparecer uma mensagem pedindo para configurar a "Tela de consentimento OAuth", clica nela:
   • Escolhe "Externo"
   • Preenche o Nome do app (pode ser Claude Drive)
   • Preenche o E-mail de suporte com o seu e-mail
   • Salva e continua (clica "Salvar e continuar" em cada tela)
   • Na tela de Escopos, clica "Salvar e continuar" sem adicionar nada
   • Na tela de Usuários de teste, adiciona o seu próprio e-mail clicando em "+ Add users"
   • Salva e termina
4. Agora volta para "Credenciais" → "+ Criar credenciais" → "ID do cliente OAuth"
5. Em Tipo de aplicativo, escolhe "App para computador"
6. Dá um nome (pode ser Claude Code)
7. Clica em "Criar"
8. Uma janela vai aparecer com seu ID do cliente e Segredo do cliente
9. Clica em "Baixar JSON" — salva esse arquivo em um lugar seguro (por exemplo: C:\Users\SeuNome\credentials.json no Windows ou /Users/SeuNome/credentials.json no Mac)

Parte 2 — Configurar no Windows

IMG_OPERATIONAL

GRID_MODE_ON

Passo 5 — Instale o servidor MCP do Google Drive

Abre o Prompt de Comando (tecla Windows + R, digita cmd, Enter) e digita:

npm install -g @modelcontextprotocol/server-gdrive

Aguarda a instalação terminar.

Passo 6 — Configure o Claude Code

O Claude Code usa um arquivo de configuração para saber quais serviços MCP usar. Você precisa editar esse arquivo.

Abre o Prompt de Comando e digita:

notepad %USERPROFILE%\.claude\settings.json

Se o arquivo não existir, o Notepad vai perguntar se quer criar — diz que sim.

Dentro do arquivo, coloca este conteúdo (se o arquivo já tiver algo, você vai precisar mesclar com cuidado):

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gdrive"
      ],
      "env": {
        "GDRIVE_CREDENTIALS_FILE": "C:\\Users\\SeuNome\\credentials.json"
      }
    }
  }
}

Importante: Troca SeuNome pelo seu nome de usuário real no Windows. Se não sabe qual é, digita echo %USERNAME% no Prompt de Comando.

Salva o arquivo (Ctrl + S) e fecha o Notepad.

Passo 7 — Autorize o acesso

1. Abre uma pasta qualquer no Explorador de Arquivos
2. Clica na barra de endereço, digita cmd, aperta Enter
3. Digita claude para abrir o Claude Code
4. Digita algo como: Liste os arquivos do meu Google Drive
5. O navegador vai abrir automaticamente pedindo para você autorizar o acesso ao Google Drive
6. Clica em "Permitir" (ou "Allow")
7. Volta para o terminal — o Claude agora pode acessar seu Drive!

Parte 2 — Configurar no Mac

Passo 5 — Instale o servidor MCP

Abre o Terminal e digita:

npm install -g @modelcontextprotocol/server-gdrive

Passo 6 — Configure o Claude Code

No Terminal, digita:

nano ~/.claude/settings.json

Se o arquivo não existir, o nano vai criar um novo. Digita (ou cola) o seguinte conteúdo:

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gdrive"
      ],
      "env": {
        "GDRIVE_CREDENTIALS_FILE": "/Users/SeuNome/credentials.json"
      }
    }
  }
}

Troca SeuNome pelo seu nome de usuário no Mac. Para saber qual é, digita whoami no Terminal.

Para salvar no nano: aperta Ctrl + X, depois Y, depois Enter.

Passo 7 — Autorize o acesso

1. No Terminal, navega para qualquer pasta e digita claude
2. Pede para o Claude listar seus arquivos do Drive
3. O navegador abre para autorização — clica em "Permitir"
4. Pronto!

Usando no Android e iPhone

IMG_OPERATIONAL

GRID_MODE_ON

O Claude Code com MCP roda em computadores. No celular, você não consegue configurar o servidor MCP diretamente. Mas tem uma alternativa:

Opção — Claude.ai pelo navegador com integração Google

A Anthropic está adicionando integrações nativas ao Claude. Você pode verificar se já tem a integração do Drive disponível:

1. Acessa https://claude.ai pelo navegador do celular
2. Clica no ícone de menu ou configurações
3. Procura por "Integrações" ou "Connections"
4. Se aparecer o Google Drive, clica para conectar
5. Autoriza o acesso com sua conta Google

Essa integração via web é mais simples mas pode ter menos funcionalidades do que o MCP no computador.

Testando se funciona

Com o Claude Code configurado, tente estes comandos:

Listar arquivos:

> Liste os arquivos da raiz do meu Google Drive

Buscar um documento:

> Encontra o documento chamado "Proposta de projeto" no meu Drive

Ler um arquivo:

> Leia o conteúdo do arquivo "relatorio-mensal.docx" e me faça um resumo

Criar um arquivo:

> Cria um documento no Google Drive chamado "Reunião de amanhã" com uma pauta básica

Dúvidas comuns

Apareceu "Error: credentials not found": Verifica se o caminho para o arquivo credentials.json está correto no settings.json. Cuidado com barras (\ no Windows, / no Mac).

O navegador não abriu para autorizar: Tenta rodar claude em um terminal comum (não dentro do VS Code) — às vezes o navegador tem dificuldade de abrir de dentro do editor.

"Access denied" ou "Insufficient permissions": Verifica se você ativou a Google Drive API no Google Cloud Console e se adicionou seu e-mail como usuário de teste na tela de consentimento OAuth.

O arquivo credentials.json é seguro? Sim, mas guarde em local seguro. Não coloca esse arquivo em repositórios públicos do GitHub. Adiciona credentials.json ao seu .gitignore.

Conectando o Google Drive ao Claude Code, você transforma o assistente em algo muito mais poderoso: ele passa a conhecer seus documentos, planilhas e arquivos, podendo trabalhar com eles de forma inteligente. É como contratar um assistente que já leu todos os seus arquivos antes de começar a trabalhar.