Campus CLI MCP server

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

Shortened. The full README is on GitHub.