Skip to main content
Glama

poli

Tu aula virtual de ESPOL (Canvas) en la terminal, y como herramientas para el agente que tú uses: Claude Code, Codex, Cursor o cualquiera que hable MCP. Lee tus tareas, anuncios, notas, mensajes, calendario, foros y el material de cada materia, baja los archivos y busca dentro de ellos.

Solo lee. No entrega, no publica y no cambia nada en el aula. Lo único que escribe es la renovación de tu propio token (abajo explico por qué).

Instalar

Necesitas uv. Funciona en Linux y macOS; en Windows, dentro de WSL.

uv tool install poli

Related MCP server: Canvas LMS MCP Server

Conectar tu cuenta

  1. En el aula virtual: Cuenta → Configuraciones → + Nuevo token de acceso. Ponle cualquier propósito y copia el token.

  2. Pégalo aquí (no se ve mientras lo pegas):

    poli login

Los tokens del aula de ESPOL vencen a la hora. poli crea uno nuevo antes de que venza el anterior y borra el viejo, y login deja programada esa renovación cada 10 minutos (un timer de systemd en Linux, un LaunchAgent en macOS). Si tu computadora pasa más de una hora apagada o dormida, la cadena se corta: creas otro token y corres poli login de nuevo. poli estado te dice cómo está.

Tu token vive en ~/.config/poli/token.env (solo tú puedes leerlo) y nunca sale de tu computadora, salvo hacia el aula. poli logout lo borra del aula y de tu máquina.

Usarlo

poli tareas --dias 7          # lo que vence esta semana
poli anuncios --curso calculo
poli notas
poli archivos --curso fisica --nombre "semana 3"
poli archivos bajar 12345
poli buscar "regla de la cadena"

Cada comando acepta --json para agentes. poli --help lista todo.

Conectarlo a tu agente

Como servidor MCP, por stdio:

claude mcp add poli -- poli mcp               # Claude Code
claude mcp add poli -- uvx poli mcp           # o sin instalar nada
codex mcp add poli -- poli mcp           # Codex

En Cursor u otro cliente, agrega un servidor MCP con el comando poli y el argumento mcp.

Si prefieres que tu agente use la CLI, hay una skill para Claude Code:

mkdir -p ~/.claude/skills/poli && poli skill > ~/.claude/skills/poli/SKILL.md

Configuración

Todo tiene un valor por defecto. Para cambiar algo, crea ~/.config/poli/config.toml:

[canvas]
url = "https://aulavirtual.espol.edu.ec"
cache_minutes = 10            # cuánto dura la copia local antes de volver a leer el aula

[material]
max_file_mb = 200             # no baja archivos más grandes

[storage]
data_dir = "~/.local/share/poli"   # la copia local y el material bajado

Las páginas escaneadas se leen con OCR si tienes tesseract con el idioma español instalado (poli ocr).

Licencia

MIT.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers