Teams Facultad MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Teams Facultad MCP Listá mis tareas próximas y leé las consignas de las que vencen primero."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Teams Facultad MCP
Consultá materias, tareas, consignas, anuncios y documentos de Teams Educación desde tu asistente de IA. Corre en tu computadora, con tu cuenta de la facu y un navegador dedicado.
Sin registrar una app en Entra ni solicitar permisos de Microsoft Graph. Lee la interfaz web que tu cuenta ya puede usar. Las políticas de tu institución siguen vigentes: esto no permite saltarse una restricción de acceso.
Instalar con mi agente de IA · Instalación manual · Guía de uso · Reportar un problema
Pedile cosas de tu cursada
“Listá mis tareas próximas y leé las consignas de las que vencen primero”.
“Mostrame los últimos anuncios de una materia”.
“Buscá el cronograma en los materiales del curso y resumilo”.
Cada compañero instala su copia e inicia sesión con su propia cuenta. El proyecto es gratuito y de código abierto; el cliente o proveedor de IA que elijas puede tener su propio costo.
Related MCP server: canvas-session-mcp
Instalá con tu agente de IA
Pegá esto en un agente con acceso a la terminal de tu computadora:
Instalá y conectá el MCP local de este repositorio:
https://github.com/Matias-Sanmiguel/teams-facultad-mcp
Leé INSTALL_WITH_AI.md y seguí su prompt de instalación completo.
USE AT YOUR OWN RISK: acepto usar este proyecto bajo mi propia responsabilidad.
Prepará el entorno, ejecutá el instalador y configurá mi cliente MCP.
Yo voy a completar el inicio de sesión y MFA en el navegador dedicado.
Verificá el resultado y avisame si el cliente necesita reiniciarse.El prompt completo incluye instalación por sistema, conservación de la configuración existente y comprobación de la conexión.
Instalación manual
Necesitás Python 3.11+, un cliente que ejecute servidores MCP locales por stdio, conexión a Internet y una sesión gráfica para iniciar sesión. Se incluyen instaladores para Windows, macOS y Linux.
1. Descargá e instalá
Descargá el ZIP de la última versión y extraelo en una carpeta permanente. También podés clonar:
git clone https://github.com/Matias-Sanmiguel/teams-facultad-mcp.git
cd teams-facultad-mcpWindows — PowerShell
py -3 scripts/install.pymacOS / Linux
sh install.shEl instalador crea .venv, instala dependencias fijadas con hashes, descarga
Chromium y genera mcp-config.json. No instala paquetes Python globales.
En Linux, Playwright puede informar que faltan bibliotecas del sistema;
seguí su diagnóstico y la guía de dependencias.
2. Iniciá sesión con tu cuenta
Windows — PowerShell
& .\.venv\Scripts\python.exe -m teams_facultad_mcp loginmacOS / Linux
.venv/bin/python -m teams_facultad_mcp loginIngresá tu cuenta de la facu y completá MFA en la ventana que se abre. Cuando Teams termine de cargar, el comando confirma la sesión y cierra el navegador.
3. Conectá tu cliente MCP
Copiá la entrada teams-facultad del archivo mcp-config.json a la configuración
de tu cliente. El archivo contiene las rutas y variables de esta computadora.
Conservá las demás entradas. Reiniciá o recargá los servidores del cliente.
{
"mcpServers": {
"teams-facultad": {
"command": "RUTA_ABSOLUTA/.venv/bin/python",
"args": ["-m", "teams_facultad_mcp", "serve"],
"env": {"TEAMS_MCP_HEADLESS": "1"}
}
}
}En Windows, command termina en .venv\\Scripts\\python.exe. Algunos clientes
usan TOML u otro formato: conservá command, args y env del archivo generado.
En Linux, env puede incluir las variables necesarias para abrir la ventana.
Si tu cliente admite tiempos máximos, usá 30 s para iniciar y 180 s por llamada.
La guía amplía estos pasos.
Consultas sin ventana
La configuración generada desde la versión de main activa
TEAMS_MCP_HEADLESS=1: el MCP consulta Teams en segundo plano usando la sesión
guardada. Si usás el ZIP v0.1.0 o una instalación anterior, agregá esa variable
dentro de env y recargá tu cliente MCP.
La ventana se usa para el ingreso inicial y MFA mediante el comando login.
Si Microsoft vuelve a pedir acceso, cerrá el cliente MCP para liberar el perfil,
ejecutá el mismo comando login del paso 2 en una terminal gráfica y reabrí el
cliente. Configurá la variable solo en el cliente MCP; la terminal de ingreso
necesita el modo visible. Para diagnosticar con una ventana, usá
TEAMS_MCP_HEADLESS=0 en la configuración del servidor.
Ocho herramientas, una sesión local
Herramienta | Qué podés consultar |
| Estado del navegador y del ingreso |
| Abrir el navegador para completar el ingreso |
| Equipos visibles y sus identificadores |
| Próximas, vencidas o completadas; filtro por materia |
| Consigna, fecha completa, estado y referencias |
| Publicaciones y respuestas visibles del canal General |
| Archivos y carpetas del canal General |
| Texto de DOCX, PPTX y PDF, por fragmentos |
Las listas pueden ser parciales por la virtualización de Teams. El MCP devuelve
completo, aviso y cursores para que el asistente lo informe. Las fechas se
conservan como aparecen en Teams. Los documentos admiten hasta 25 MiB;
no hay OCR ni extracción de imágenes o diagramas.
Tu cuenta queda en tu computadora
El perfil de Chromium se guarda fuera del repositorio, en el directorio de datos de tu usuario. No se usa el perfil de tu navegador habitual. El servidor no aloja tu sesión ni manda documentos a un servicio propio. Los resultados consultados pueden llegar al proveedor de IA de tu cliente, según su configuración.
No compartas el perfil del navegador ni mcp-config.json. Cada persona debe
instalar e iniciar sesión por su cuenta. Microsoft puede pedirte volver a entrar.
Las herramientas consultan contenido: no envían mensajes, entregan trabajos ni editan documentos. Abrir anuncios puede marcarlos como leídos y Teams puede actualizar tu presencia. Una actualización de su interfaz puede requerir ajustes al conector. Más sobre alcance y datos locales.
USE AT YOUR OWN RISK
Usá este proyecto bajo tu propia responsabilidad. Se ofrece “tal cual”, sin garantías de disponibilidad, exactitud, integridad ni compatibilidad futura. Verificá fechas, consignas y entregas directamente en Teams. Sos responsable del uso de tu cuenta, de los datos que compartís con tu asistente y de respetar las normas de tu institución. Los autores no asumen responsabilidad por daños o pérdidas derivados del uso, en la medida permitida por la ley. Se aplican los términos y la exclusión de garantías de la licencia MIT.
Proyecto independiente, sin afiliación con Microsoft ni con ninguna universidad. Los nombres de productos pertenecen a sus respectivos titulares.
Desarrollo y contribuciones
.venv/bin/python -m pip install --require-hashes -r requirements-dev.lock
.venv/bin/python -m pytest -q
.venv/bin/python -m build
.venv/bin/python scripts/package.pyLas pruebas usan Chromium real con páginas sintéticas, sin una cuenta de la facu. La matriz de CI cubre Linux, Windows y macOS; las pruebas con una cuenta real se realizaron en Linux. Qué verificamos y qué falta.
Para contribuir, abrí un issue o un PR con la reproducción, la versión del sistema
y el resultado de doctor sin datos privados. No adjuntes cookies, capturas de
clases, URLs de autenticación ni documentos personales.
Available Tools
8 toolsestado_conexionBRead-only
Comprueba si el navegador está abierto y si Teams requiere autenticación.
Inputs: no named parameters. Returns: object
iniciar_sesionA
Abre un navegador dedicado para ingreso y MFA en modo visible. En modo sin ventana, usar login desde una terminal gráfica con el cliente MCP cerrado. Devuelve pronto; consultar estado_conexion después.
Inputs: no named parameters. Returns: object
leer_anunciosBRead-only
Lee publicaciones y respuestas visibles del canal General. Abrirlas puede marcarlas como leídas.
Inputs: materia_id (required), cursor, limite. Returns: object
leer_documentoARead-only
Extrae texto de DOCX, PPTX o PDF (máximo 25 MiB) en fragmentos. Sin OCR; puede devolver texto parcial del visor.
Inputs: archivo_id (required), cursor, limite_caracteres. Returns: object
leer_tareaARead-only
Lee consigna, vencimiento, estado y materiales de un ID obtenido con listar_tareas.
Inputs: tarea_id (required). Returns: object
listar_archivosCRead-only
Lista carpetas y materiales del canal General; carpeta_id se obtiene del listado anterior.
Inputs: materia_id (required), cursor, limite, carpeta_id. Returns: object
listar_materiasBRead-only
Lista equipos visibles con IDs opacos; puede incluir equipos que no sean clases.
Inputs: cursor, limite. Returns: object
listar_tareasBRead-only
Consulta tareas, materia y fechas originales. Usa leer_tarea para la fecha completa y la consigna.
Inputs: cursor, estado, limite, materia_id. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool targets a distinct action/resource: connection check vs. login, list vs. read for both assignments and files, and separate tools for announcements and document extraction. The descriptions explicitly chain tools together (IDs come from listar_tareas/listar_archivos), which removes residual ambiguity about which tool to call first.
Seven of eight names follow a clean Spanish verb_noun pattern (listar_*, leer_*, iniciar_sesion) with consistent snake_case. The single deviation is estado_conexion, a noun phrase that breaks the verb-first convention, though it remains readable and predictable.
Eight tools is well within the ideal range and each one earns its place: two session tools, three navigation/listing tools, and three content-reading tools. No redundant or filler tools are present.
The surface covers the read-only workflow end to end: authenticate, discover courses, list and open assignments, read announcements, browse files, and extract document text. Gaps are minor for the apparent inspection scope — no write actions (reply to announcement, submit assignment) and no search across courses.
Maintenance
Related MCP Connectors
Web search, data extraction and controlled browser automation for AI assistants via OAuth.
Let AI agents use any website you're logged in to. Sessions stay encrypted on your machine.
Run the Geduk LMS from an AI assistant: courses, sessions, enrolments, users and catalogue.
Connect AI assistants to Edusign attendance, courses, learners, documents, and API docs via OAuth.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to read your own Microsoft Teams chats, listing conversations and retrieving chat messages as plain text through Microsoft Graph. It runs locally with delegated, read-only permissions under your own Entra app registration.1,796 npmMIT
- AlicenseNot gradedqualityCmaintenanceConnects Claude, Cursor, Codex and other AI assistants to Canvas LMS through a normal browser sign-in (SSO and MFA included) instead of an access token, letting them read courses, assignments, rubrics, announcements, discussions, grades, calendar and inbox, and read or save course files locally. It is strictly read-only, sending only GET requests, and keeps all session data on the user's own machine.4MIT
- AlicenseNot gradedqualityCmaintenanceLets AI assistants read a student's Canvas LMS/Moodle courses, deadlines, announcements, grades and course files using their normal browser login instead of an access token. It is read-only and keeps all session data and downloads on the user's own machine.36 npm1MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to access and manage academic course information, assignments, submissions, grades, calendars, materials, recordings, and announcements through authenticated LMS sessions.MIT