olk — Microsoft Outlook en tu terminal

olk es un CLI scriptable y servidor MCP para correo, calendarios, contactos, tareas y OneDrive de Outlook a través de Microsoft Graph. Funciona con cuentas personales de Outlook.com y cuentas empresariales de Microsoft 365.

Instalación

brew install rlrghb/tap/olk
# or
go install github.com/rlrghb/olkcli/cmd/olk@latest

El paquete npm es olkcli; el comando instalado es olk:

npm install -g olkcli

Consulta las notas de macOS si macOS solicita acceso al Llavero después de una actualización.

Related MCP server: Microsoft MCP

Inicio rápido

olk auth login
olk auth status
olk mail list --json --results-only --select id,subject,from
olk mail search 'from:person@example.com subject:urgent'
olk calendar view --days 7
olk contacts search "Alex"
olk todo lists list
olk drive ls

Para cuentas de trabajo/escuela y funciones solo empresariales:

olk auth login --enterprise

Comandos comunes

Consulta la referencia de comandos para todos los comandos y opciones.

Salida y scripting

Los resultados se escriben en stdout; los diagnósticos y avisos van a stderr.

olk mail list --json --results-only | jq '.[].subject'
olk contacts list --plain

Los modos de salida son JSON (--json), TSV (--plain) y tablas alineadas por defecto. Usa --concise para omitir cuerpos/vistas previas grandes y --select para limitar campos donde se admita. Consulta scripting y sincronización.

Valores predeterminados de seguridad

• Usa --no-write --no-send --no-input para ejecuciones de solo lectura sin supervisión.

• MCP expone herramientas seleccionadas y requiere aceptación explícita para mutaciones.

• El texto externo de correo, calendario, contactos y archivos se puede envolver con --wrap-untrusted para un consumo seguro por agentes.

• Los tokens de actualización se almacenan en el llavero del sistema; los tokens de acceso se mantienen solo en memoria.

Lee la guía de seguridad y privacidad antes de conectar un agente o compartir registros.

Documentación

• Referencia de comandos

• Autenticación y cuentas

• Scripting y sincronización

• MCP y agentes de IA

• Seguridad y privacidad

• Configuración de aplicaciones empresariales

• Desarrollo y versiones

• Instrucciones para agentes

Contribuciones

make build
make test
make lint

Consulta desarrollo y versiones para la estructura del repositorio, validación, CI y detalles de publicación.

Licencia

Consulta LICENSE.