Gmail Rascunhos

Rascunha respostas de e-mail no seu tom — nunca envia automaticamente.

Este plugin do Claude Code usa a API do Gmail (via OAuth 2.0) para ler suas conversas e criar rascunhos de resposta que soam como você. A premissa de segurança é absoluta: o plugin só cria rascunhos. Você sempre tem a palavra final — revisa, edita e clica em enviar dentro do Gmail. Nada sai sem você.

O que faz

O gmail-rascunhos transforma o Claude Code em um assistente de escrita de e-mails que respeita o seu estilo. Com ele você pode:

• Gerar um rascunho de resposta para uma conversa específica, no seu tom de voz, já anexado à thread correta no Gmail.
• Produzir um lote de follow-ups para vários e-mails que ficaram sem resposta, cada um como rascunho individual.
• Calibrar o tom (formal, próximo, direto, caloroso) e o idioma de cada rascunho.
• Manter o contexto da conversa (citações, assunto, destinatários) para que o rascunho faça sentido na thread.

O que ele não faz: não envia e-mails, não apaga mensagens, não marca como lido sem você pedir, não responde sozinho.

Instalação

1. No Google Cloud Console, crie um projeto e ative a Gmail API.
2. Configure uma credencial OAuth 2.0 (cliente do tipo Desktop ou Web) e gere um refresh token com o escopo necessário (recomendado: https://www.googleapis.com/auth/gmail.compose, que permite criar rascunhos mas não enviar de forma irrestrita).
3. Copie a pasta deste plugin para o diretório de plugins do seu projeto Claude Code.
4. Defina as variáveis de ambiente descritas em Configuração.
5. Reinicie a sessão do Claude Code para carregar os comandos.

Comandos disponíveis

• /rascunhar-resposta — Cria um rascunho de resposta para uma conversa específica, no seu tom de voz, anexado à thread correta.
• /rascunhar-followups — Varre e-mails sem resposta e gera um lote de rascunhos de follow-up, um para cada conversa.

Configuração

O plugin lê as credenciais exclusivamente de variáveis de ambiente. Use apenas os nomes abaixo no seu .env local ou gerenciador de segredos — nunca coloque os valores reais em arquivos versionados.

| Variável de ambiente | Para que serve |

| --- | --- |

| GMAIL_OAUTH_CLIENT_ID | ID do cliente OAuth 2.0 do seu projeto no Google Cloud. |

| GMAIL_OAUTH_CLIENT_SECRET | Segredo do cliente OAuth 2.0, usado para trocar o refresh token por tokens de acesso. |

| GMAIL_OAUTH_REFRESH_TOKEN | Refresh token de longa duração que autoriza o acesso à sua caixa do Gmail. |

Boas práticas:

• Use o escopo mínimo necessário. Para criar rascunhos, gmail.compose basta e evita conceder permissão ampla de envio.
• Trate o GMAIL_OAUTH_REFRESH_TOKEN como uma senha: ele dá acesso contínuo à sua conta. Rotacione e revogue se houver suspeita de vazamento.
• Não compartilhe a mesma credencial entre projetos diferentes.

Exemplo de uso

Rascunhar uma resposta calorosa, em português, para a conversa mais recente de um cliente:

/rascunhar-resposta [email protected] tom=caloroso idioma=pt-BR

O Claude vai:

1. Localizar a thread mais recente com aquele remetente.
2. Ler o histórico da conversa para entender o contexto.
3. Estudar o seu estilo (a partir de exemplos de e-mails seus, se disponíveis) para acertar o tom.
4. Criar um rascunho anexado à thread, com assunto e destinatários corretos.

Você abre o Gmail, encontra o rascunho na conversa, revisa, ajusta o que quiser e envia — ou não.

Para limpar a caixa de itens parados:

/rascunhar-followups idade=7d max=10 tom=direto

gera até 10 rascunhos de follow-up para conversas suas que estão há mais de 7 dias sem resposta.

Segurança e limites

• Só rascunhos, sempre. O plugin usa a API do Gmail apenas para criar rascunhos (drafts.create). Ele nunca chama o envio. A decisão de enviar é 100% sua, dentro do Gmail.
• Escopo mínimo. Prefira o escopo gmail.compose para que a credencial sequer tenha permissão ampla de envio.
• Segredos protegidos. As credenciais ficam só em variáveis de ambiente; nunca aparecem em logs ou na saída dos comandos.
• Privacidade. O conteúdo dos seus e-mails é lido apenas para gerar os rascunhos solicitados. Não há cópia, encaminhamento ou exfiltração.
• Limites da API. O Gmail aplica cotas de uso. O comando de lote processa em pequenos blocos e respeita as cotas; se atingir o limite, ele pausa e informa.
• Revisão humana. Trate todo rascunho como um ponto de partida. Releia antes de enviar — o tom pode precisar de ajuste e fatos devem ser conferidos.