# Unlam MCP

> Unlam MCP is an open-source MCP server for learning management. MCP server giving AI assistants access to UNLaM's MIeL campus and Intraconsulta records. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, VS Code, macOS, Windows, Linux
- **Website:** https://unlam-mcp.vercel.app
- **Repository:** https://github.com/blasestevez/unlam-mcp
- **MCP Registry name:** io.github.blasestevez/unlam-mcp
- **Categories:** [learning management](https://ai-powered.com/categories/learning-management)
- **Listing updated:** 2026-11-20

## About

The README says this unofficial server connects AI assistants to MIeL, the virtual campus of Universidad Nacional de La Matanza, and to Intraconsulta, so a student can ask about courses, materials, forums, assignments and academic records in natural language. It runs locally over stdio, which keeps login credentials on the user's machine rather than in a remote service.

Most tools are read-only, covering course listings, the class calendar, downloadable files, forum threads, messages, grades, attendance and exam slots. The server also includes a small set of write actions: booking and cancelling turnos, sending messages with attachments, and submitting practical assignments. The README states these run only when the user asks for them, and that the server re-reads MIeL to confirm each change.

Credentials are stored in the operating system keychain through a login command, or can be supplied as environment variables. It is aimed at students at UNLaM who use an MCP-capable client such as Claude, Cursor or VS Code.

## Features

- **Course and calendar lookup:** Lists enrolled subjects, exams, deadlines and defences across all courses in one query.
- **Course file reading:** Downloads course materials and extracts text from PDF, Word and PowerPoint files, or renders PDF pages as images.
- **Forum and message access:** Reads forum threads, the course message inbox and individual messages with their attachments.
- **Academic record summary:** Pulls passed subjects, grades, origin of each pass and a simple average from Intraconsulta.
- **Turno booking and submissions:** Books or cancels turnos, sends course messages and uploads practical assignments on request.
- **Keychain credential storage:** Saves MIeL credentials in the system keychain through a login command rather than in config files.

## Good for

- Asking an assistant what changed in MIeL this week across all subjects
- Summarising a course handout or unit document from a PDF
- Checking upcoming practical deadlines, grades and attendance
- Booking or cancelling a recuperatorio slot from a chat client
- Downloading the academic history PDF from Intraconsulta

## Install

### Claude Code (Terminal)

```sh
claude mcp add unlam-mcp --env MIEL_CLAVE='<MIEL_CLAVE>' -- uvx unlam-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "unlam-mcp": {
      "command": "uvx",
      "args": [
        "unlam-mcp"
      ],
      "env": {
        "MIEL_CLAVE": "<MIEL_CLAVE>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "unlam-mcp": {
      "command": "uvx",
      "args": [
        "unlam-mcp"
      ],
      "env": {
        "MIEL_CLAVE": "<MIEL_CLAVE>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "unlam-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "unlam-mcp"
      ],
      "env": {
        "MIEL_CLAVE": "<MIEL_CLAVE>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "unlam-mcp": {
      "command": "uvx",
      "args": [
        "unlam-mcp"
      ],
      "env": {
        "MIEL_CLAVE": "<MIEL_CLAVE>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "unlam-mcp": {
      "command": "uvx",
      "args": [
        "unlam-mcp"
      ],
      "env": {
        "MIEL_CLAVE": "<MIEL_CLAVE>"
      }
    }
  }
}
```

## Tools

- `miel_novedades`: Updates across all subjects: new files, unread messages and active forums.
- `miel_materias`: The user's subjects with class group and pending items.
- `miel_calendario`: Exams, retakes, deliverables and defences for all subjects with date, place and time.
- `miel_contenidos`: Files and links published by teachers, with folder, date and new-item flag.
- `miel_leer`: Extracts text from a PDF, Word, PowerPoint or plain text document.
- `miel_ver_pagina`: Renders a PDF page as an image.
- `miel_descargar`: Downloads a file or message attachment locally.
- `miel_foro`: Forum topics for a subject with unread counts.
- `miel_foro_tema`: Messages in a forum topic.
- `miel_mensajes`: Subject message inbox.
- `miel_mensaje`: Full content of a message with its attachments.
- `miel_destinatarios`: Available recipients in a subject.
- `miel_practicas`: Assignments and exams with due date, submission and grading status.
- `miel_asistencia`: Attendance per class with summary and online evaluation grades.
- `miel_grupos`: Working groups per subject and their members.
- `miel_evaluaciones`: Online evaluations for a subject and their availability status.
- `miel_turnos`: Turnos for a subject with date, place, vacancies and booking status.
- `miel_reservar_turno`: Books a turno.
- `miel_cancelar_turno`: Cancels a booked turno.
- `miel_enviar_mensaje`: Sends a subject message with an optional attachment.
- `miel_entregar_practica`: Submits a practical assignment file.
- `intraconsulta_materias_en_curso`: Subjects enrolled in the current term with schedule and classroom.
- `intraconsulta_historia_academica`: Passed subjects with grade, date and origin, plus a simple average.
- `intraconsulta_descargar_historia_academica`: Downloads the academic history PDF.
- `intraconsulta_regularizadas`: Subjects with passed coursework and a pending final exam.
- `intraconsulta_constancias`: Subjects or exam tables with an available exam certificate.
- `intraconsulta_descargar_constancia`: Downloads an exam certificate PDF.

## FAQ

### Is this an official UNLaM product?

No. The README states it is an unofficial project with no relation to UNLaM.

### Where are my credentials stored?

The README says the login command saves them in the operating system credential manager, not in text files or client configuration. Environment variables are an alternative for setups without a keychain.

### Can the server post to the forum or start evaluations?

No. The README says the forum and evaluations are read-only, and the server does not post to the forum or start evaluations.

### Which AI clients does Unlam MCP support?

The README lists Claude, Cursor, VS Code (Copilot), Windsurf, Codex and Gemini CLI, among other MCP clients that support local stdio servers.

### Is Unlam MCP free?

Yes. Unlam MCP is open source, so you can use and self-host it for free.

### How do I add Unlam MCP to Claude Code?

Run this command in your terminal: claude mcp add unlam-mcp --env MIEL_CLAVE='<MIEL_CLAVE>' -- uvx unlam-mcp

### What are the best alternatives to Unlam MCP?

The closest alternatives to Unlam MCP are EduBase and Canvas.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [EduBase](https://ai-powered.com/mcp/edubase): EduBase is an open-source MCP server for learning management.
- [Canvas](https://ai-powered.com/mcp/canvas): Canvas is an open-source MCP server for learning management.

---
Source: https://ai-powered.com/mcp/unlam-mcp
