campus-cli

Conecta Blackboard UPC con ChatGPT y Claude (vía MCP), o úsalo directo desde la terminal.

campus-cli (también conocido como Campus o Campus CLI, campuscli.com) es un CLI y servidor MCP no oficial para estudiantes de UPC. Le da a asistentes de IA como ChatGPT y Claude acceso directo a tu Blackboard Learn: cursos, tareas, notas, anuncios, mensajes y materiales, sin abrir el navegador. Canvas y Moodle están en el roadmap.

No confundir con: el paquete campus-cli de PyPI (Python, gestión de notebooks de Jupyter, proyecto no relacionado) ni con otras plataformas de "IA para programadores" o "resolver tareas con IA" que usan nombres parecidos — este proyecto es específicamente la integración de Blackboard con asistentes de IA vía MCP.

npx campus-cli@2.0.0 account login
campus courses list
campus assignments list --pending

English summary — campus-cli is an unofficial Blackboard MCP server and CLI for students. It exposes Blackboard Learn (currently UPC Aula Virtual, Peru) to any Model Context Protocol client — Claude Desktop, Claude Code, Cursor, GitHub Copilot, Codex CLI, Windsurf — so an AI assistant can read your courses, assignments, due dates, grades, instructor feedback, announcements and course materials, and download files, without you copying anything by hand. Unlike institutional Blackboard integrations, it needs no OAuth developer key from your university: it uses the student's own SSO session, locally. Run it with npx campus-cli@2.0.0 mcp (stdio). Canvas and Moodle are on the roadmap.

Qué puedes hacer

• Ver tus cursos del ciclo.
• Consultar tu horario semanal, con horas y aulas de tus cursos matriculados.
• Revisar tareas pendientes, fechas de entrega y notas.
• Descargar archivos y carpetas completas de Blackboard.
• Buscar publicaciones en Crossref, OpenAlex, ACM, Scopus y Web of Science; entregar las fuentes como resource_link para que la IA cliente las analice; y verificar DOI, fragmentos, páginas/secciones y huellas del documento. Google Académico admite SerpApi opcional o enlaces manuales. Consulta la configuración de investigación académica.
• Consultar anuncios, mensajes, contenidos y calificaciones.
• En un host de Campus que registre la función y autorice el acceso, obtener guías y plantillas APA 7 en español. El servidor MCP local iniciado con npx campus-cli ... mcp no la registra.
• Usarlo desde Claude, Cursor, Copilot, Codex u otro cliente compatible con MCP.
• Automatizar consultas con --json o con llamadas directas a la API de Blackboard.

Estado actual

Si estudias en una universidad con Canvas o Moodle y quieres ayudar a probar o implementar soporte, abre un issue para coordinar.

Requisitos

• Node.js 22.13.0 o superior.
• Una cuenta activa de UPC con acceso a Aula Virtual.
• Acceso al flujo normal de Microsoft SSO, incluyendo MFA si tu cuenta lo pide.
• macOS, Linux o Windows con un entorno donde Playwright pueda abrir Chromium.

Instalación rápida

Usar sin instalar

npx campus-cli@2.0.0 account login

Instalar globalmente

npm install -g campus-cli@2.0.0
campus account login

Clonar el repo

git clone https://github.com/alejooroncoy/campus-cli
cd campus-cli
npm install
node run.js account login

campus-cli usa Playwright para abrir Chromium durante el login. npm install intenta instalar Chromium automáticamente; si el navegador falta, el CLI lo instala la primera vez que lo necesite.

Primer uso

campus account login

Se abre el navegador para iniciar sesión con tu cuenta Campus (Google) — es la identidad compartida entre las apps del ecosistema Campus, separada de tu sesión de Blackboard. Al terminar, encadena automáticamente el login de Microsoft UPC (Blackboard SSO, 100% local, sin pasar por ningún servidor propio). Si más adelante corres campus login por separado, te pedirá primero campus account login en caso de no tener una cuenta Campus activa.

Inicia sesión con tu cuenta universitaria y completa MFA si aplica.

Durante el login, Microsoft puede mostrar "Stay signed in?" con el checkbox "Don't show this again". Marca ese checkbox y haz clic en Yes para que la sesión pueda mantenerse correctamente.

Después del login:

campus courses list

Ejemplo:

_100001_1  Cálculo Diferencial e Integral [Ultra]
_100002_1  Programación Orientada a Objetos [Ultra]
_100003_1  Bases de Datos [Ultra]
_100004_1  Algoritmos y Estructuras de Datos [Ultra]

Luego puedes revisar tareas de un curso:

campus assignments list _100004_1 --pending

Ejemplo:

_200001_1  Tarea 1  [manual]
  Nota: sin entregar · Máx: 5 pts · Entrega: 15/04/2026

Comandos principales

Cuenta Campus

campus account login      # iniciar sesión con Google (encadena el login de Blackboard)
campus account whoami     # cuenta Campus activa
campus account logout     # cerrar sesión de la cuenta Campus en este equipo

Sesión (Blackboard)

campus login              # iniciar sesión con Microsoft SSO (pide cuenta Campus primero)
campus logout             # borrar sesión local
campus whoami             # usuario activo y tiempo restante
campus status             # sesión + versión del servidor Blackboard

Cursos

campus courses list
campus courses get <courseId>
campus courses contents <courseId>
campus courses contents <courseId> --parent <folderId>
campus courses contents <courseId> --type file|folder|assignment
campus courses announcements <courseId>
campus courses grades <courseId>
campus courses discussions <courseId>
campus courses discussion <courseId> <discussionId>
campus courses discussion-messages <courseId> <discussionId>
campus courses discussion-replies <courseId> <discussionId> <messageId>
campus messages
campus messages --course <courseId>

Tareas

campus assignments list <courseId>
campus assignments list
campus assignments list --pending
campus assignments list <courseId> --pending
campus assignments attempts <courseId> <assignmentId>
campus assignments submit <courseId> <assignmentId> -f tarea.pdf
campus assignments submit <courseId> <assignmentId> -t "Mi respuesta" -c "Comentario"
campus assignments submit <courseId> <assignmentId> -f borrador.pdf --draft

Descargas

campus download <courseId> <contentId>
campus download-folder <courseId> <folderId> -o ./materiales/
campus download-folder <courseId> <folderId> --filter "parcial"

API y scripting

campus api GET /learn/api/public/v1/users/me
campus api GET /learn/api/public/v1/courses -q "limit=10"
campus endpoints
campus endpoints --json

Todos los comandos aceptan --json. Los spinners van a stderr, así que puedes usar --json 2>/dev/null para obtener JSON limpio en scripts.

CLI o MCP

Puedes usar ambos modos con la misma sesión. Primero ejecuta campus login; luego usa el CLI manualmente o conecta el servidor MCP a tu cliente de IA.

Uso con IA mediante MCP

campus-cli incluye un servidor MCP estándar. Corre por stdio con:

npx campus-cli@2.0.0 mcp

Eso permite conectar tu campus a clientes como Claude, Cursor, GitHub Copilot, OpenAI Codex CLI, Windsurf y otros clientes compatibles con Model Context Protocol.

Además de las herramientas de Blackboard, el MCP incluye banner_get_weekly_schedule: consulta tu matrícula en Banner UPC y organiza las clases de lunes a domingo. Por defecto usa el período activo; también puedes pasar un código de período si quieres revisar un ciclo anterior. campus_get_weekly_schedule sigue disponible como alias deprecado para integraciones existentes.

Claude Code

Agrega esto a .mcp.json:

{
  "mcpServers": {
    "campus": {
      "command": "npx",
      "args": ["campus-cli@2.0.0", "mcp"]
    }
  }
}

Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "campus": {
      "command": "npx",
      "args": ["campus-cli@2.0.0", "mcp"]
    }
  }
}

Cursor

Usa Settings -> MCP -> Add new MCP server, o edita ~/.cursor/mcp.json:

{
  "mcpServers": {
    "campus": {
      "command": "npx",
      "args": ["campus-cli@2.0.0", "mcp"]
    }
  }
}

GitHub Copilot en VS Code

Crea .vscode/mcp.json:

{
  "servers": {
    "campus": {
      "type": "stdio",
      "command": "npx",
      "args": ["campus-cli@2.0.0", "mcp"]
    }
  }
}

OpenAI Codex CLI

Agrega esto a ~/.codex/config.toml:

[mcp_servers.campus]
command = "npx"
args = ["campus-cli@2.0.0", "mcp"]

Windsurf

Edita ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "campus": {
      "command": "npx",
      "args": ["campus-cli@2.0.0", "mcp"]
    }
  }
}

Si instalaste el paquete globalmente con npm install -g campus-cli@2.0.0, puedes reemplazar npx campus-cli@2.0.0 por la ruta absoluta de campus.

Configuración mínima

Todos los clientes MCP terminan usando la misma idea:

{
  "command": "npx",
  "args": ["campus-cli@2.0.0", "mcp"]
}