claudia-gmail
Skill39 starsChanged 7 months agoMITView on GitHub
Lee, busca, organiza, crea borradores y envía correos en Gmail. Usar cuando el usuario pida revisar correo, buscar emails, crear borradores o gestionar su bandeja.
- Reads credentials
- Installs packages
In this repository21 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- claudia-blueprintSkill
- claudia-calendarSkill
- claudia-corpus-syncSkill
- claudia-critiqueSkill
- claudia-finanzasSkill
- claudia-imageSkill
- claudia-intakeSkill
- claudia-onboardingSkill
- claudia-researchSkill
- claudia-scrapeSkill
- claudia-thinkingSkill
- claudia-updateSkill
- claudia-wisdomSkill
- claudia-yt-analyticsSkill
- claudia-yt-transcriptSkill
- memory-searchSkill
- notesSkill
- telegram-botSkill
- vault-searchSkill
- weekly-reviewSkill
The file
Files
Gmail — Gestión de correo
Gmail API v1 con OAuth2 scope gmail.modify (leer, organizar, borradores, envío).
Personalización: antes de ejecutar, lee
user/behavior.mden este directorio. Si tiene contenido, aplícalo como ajustes sobre el comportamiento de esta skill — en caso de conflicto con lo definido aquí, prevalece lo del usuario.
Uso
Siempre con el venv de la skill (si existe) o python3 del sistema:
python3 .claude/skills/claudia-gmail/gmail.py --account personal --action list [--max 20] [--unread]
python3 .claude/skills/claudia-gmail/gmail.py --account personal --action read --id <message_id>
python3 .claude/skills/claudia-gmail/gmail.py --account personal --action search --query "from:juan"
python3 .claude/skills/claudia-gmail/gmail.py --account personal --action draft --to "a@b.com" --subject "Re: X" --body "Hola..."
python3 .claude/skills/claudia-gmail/gmail.py --account personal --action archive --id <message_id>
python3 .claude/skills/claudia-gmail/gmail.py --account personal --action label --id <message_id> --label "Clientes"
python3 .claude/skills/claudia-gmail/gmail.py --action accountsAliases de contactos
Fichero compartido: user/config/settings.json (key calendar_aliases, el mismo que usa Calendar). Mapea emails a nombres cortos. En listados y búsquedas, el remitente se muestra con el alias en vez de la dirección completa.
{
"juan@example.com": "Juan",
"contabilidad@empresa.com": "Gestoría",
"noreply@github.com": "GitHub"
}El campo message_id_header solo aparece al leer un correo concreto (necesario para reply-to), no en listados.
Configuración asistida de aliases
Tras completar el setup de Gmail, ofrece al usuario configurar aliases:
- Ejecuta
gmail.py --account <cuenta> --action list --max 20para ver remitentes recientes - Extrae las direcciones únicas del campo
from - Muestra al usuario: "He encontrado estos remitentes frecuentes: [lista]. ¿Quieres asignar alias a alguno? Así en futuros listados verás el nombre corto en vez del email."
- Con las respuestas, escribe la key
calendar_aliasesenuser/config/settings.json(o actualiza si ya existe, respetando entradas previas de Calendar u otras skills)
Reglas
- Envío existe pero no es el modo por defecto. El comando
--action sendestá disponible en el código, pero nunca lo uses sin cumplir las dos condiciones:user/context/constraints.mdlo autoriza explícitamente para el contexto actual (p.ej. briefings automáticos, intake) o el usuario lo confirma en la conversación.- Has mostrado al usuario el contenido exacto (destinatario, asunto, cuerpo) antes de enviar.
- Modo seguro por defecto: crea un borrador (
--action draft) y pide al usuario que lo revise y envíe desde Gmail. Los borradores siempre son reversibles; unsendno. - Cuentas configuradas: ver con
--action accounts
Setup (primera vez)
Gmail usa OAuth2, no API keys simples. La configuración tiene dos pasos:
Paso 1 — Obtener credentials.json (una sola vez)
- Ve a https://console.cloud.google.com/apis/credentials
- Crea un proyecto (o selecciona uno existente)
- Habilita la API de Gmail: APIs & Services → Library → busca "Gmail API" → Enable
- Configura la pantalla de consentimiento: OAuth consent screen → External → crea
- Crea credenciales: Create Credentials → OAuth client ID → Desktop app
- Descarga el JSON y guárdalo como
user/credentials/gmail/credentials.json
Paso 2 — Autorizar una cuenta
python3 .claude/skills/claudia-gmail/auth.py personalauth.py arranca un servidor loopback en 127.0.0.1:<puerto>, abre el navegador y captura el código de Google automáticamente (flujo oficial "Installed App" de Google). El token queda guardado en user/credentials/gmail/tokens/personal.json.
En un VPS sin entorno gráfico, abre antes un túnel SSH hacia un puerto fijo desde tu máquina local:
ssh -L 8765:127.0.0.1:8765 usuario@tu-servidor
# y en el servidor:
python3 .claude/skills/claudia-gmail/auth.py personal --port 8765 --no-browserCopia la URL impresa y ábrela en el navegador local. La redirección http://127.0.0.1:8765/?code=… llegará al servidor remoto por el túnel.
Puedes autorizar varias cuentas con nombres distintos:
python3 .claude/skills/claudia-gmail/auth.py trabajoDependencias Python
pip install google-auth google-auth-oauthlib google-api-python-clientSin credentials.json, el script auth.py mostrará instrucciones al ejecutarse.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

