Cómo conectar Claude con Gmail paso a paso

# Estructura de tu proyecto
# proyecto/
# ├── credentials.json   <- descargado de Google Cloud
# ├── gmail_claude.py
# └── requirements.txt

python -m venv venv
source venv/bin/activate   # En Windows: venv\Scripts\activate

pip install google-auth google-auth-oauthlib \
            google-api-python-client anthropic

import os, base64
from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

SCOPES = ['https://www.googleapis.com/auth/gmail.modify']

def get_service():
    creds = None
    if os.path.exists('token.json'):
        creds = Credentials.from_authorized_user_file('token.json', SCOPES)
    if not creds or not creds.valid:
        if creds and creds.expired and creds.refresh_token:
            creds.refresh(Request())
        else:
            flow = InstalledAppFlow.from_client_secrets_file('credentials.json', SCOPES)
            creds = flow.run_local_server(port=0)
        with open('token.json', 'w') as f:
            f.write(creds.to_json())
    return build('gmail', 'v1', credentials=creds)

def leer_correos(service, n=5):
    res = service.users().messages().list(userId='me', maxResults=n, q='is:unread').execute()
    correos = []
    for m in res.get('messages', []):
        msg = service.users().messages().get(userId='me', id=m['id']).execute()
        headers = {h['name']: h['value'] for h in msg['payload']['headers']}
        body = extraer_cuerpo(msg['payload'])
        correos.append({'id': m['id'], 'asunto': headers.get('Subject',''),
                        'de': headers.get('From',''), 'cuerpo': body})
    return correos

def extraer_cuerpo(payload):
    if 'parts' in payload:
        for p in payload['parts']:
            if p['mimeType'] == 'text/plain' and p['body'].get('data'):
                return base64.urlsafe_b64decode(p['body']['data']).decode('utf-8', 'ignore')
    data = payload['body'].get('data')
    return base64.urlsafe_b64decode(data).decode('utf-8','ignore') if data else ''

import anthropic

client = anthropic.Anthropic(api_key=os.environ['ANTHROPIC_API_KEY'])

def resumir_con_claude(correo):
    prompt = f"""Resume este correo en 2 frases y asígnale una prioridad (ALTA/MEDIA/BAJA).

De: {correo['de']}
Asunto: {correo['asunto']}
Cuerpo:
{correo['cuerpo'][:4000]}

Responde en formato:
Prioridad: <nivel>
Resumen: <texto>"""
    resp = client.messages.create(
        model='claude-opus-4-8',
        max_tokens=300,
        messages=[{'role': 'user', 'content': prompt}]
    )
    return resp.content[0].text

service = get_service()
for c in leer_correos(service, n=5):
    print(f"\n=== {c['asunto']} ===")
    print(resumir_con_claude(c))

from email.mime.text import MIMEText

def redactar_respuesta(correo):
    prompt = f"""Redacta una respuesta profesional y cordial en español a este correo.
Asunto: {correo['asunto']}
Contenido: {correo['cuerpo'][:3000]}
Devuelve solo el cuerpo de la respuesta."""
    resp = client.messages.create(model='claude-opus-4-8', max_tokens=600,
        messages=[{'role':'user','content':prompt}])
    return resp.content[0].text

def crear_borrador(service, correo, texto):
    mime = MIMEText(texto)
    mime['To'] = correo['de']
    mime['Subject'] = 'Re: ' + correo['asunto']
    raw = base64.urlsafe_b64encode(mime.as_bytes()).decode()
    borrador = service.users().drafts().create(
        userId='me', body={'message': {'raw': raw}}).execute()
    return borrador['id']

for c in leer_correos(service, n=3):
    respuesta = redactar_respuesta(c)
    bid = crear_borrador(service, c, respuesta)
    print(f"Borrador creado ({bid}) para: {c['asunto']}")