# UniMCP

> UniMCP is an open-source MCP server for education and exams. Read your Moodle classroom and SIU Guaraní records from an AI assistant, in Argentina. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/hynuwa/unimcp
- **MCP Registry name:** io.github.HyNuwa/unimcp
- **Categories:** [education and exams](https://ai-powered.com/categories/education-and-exams)
- **Listing updated:** 2026-11-18

## About

UniMCP is an unofficial bridge between an AI assistant and the systems an Argentine university student already uses: the Moodle virtual classroom and the SIU Guaraní self-service portal. Its README lists sample questions such as when a make-up exam is, what a teacher announced this week, what is due, how a grade came out and which finals are passed. In Guaraní it can answer which subjects you are enrolled in and which exam dates exist for a course. With your confirmation it can also post to forums or hand in assignments.

A registry of campuses maps each to its Moodle and Guaraní addresses, covering universities such as UNJu, UNSa, UNT, UBA, UTN regionals, UNC, UNCuyo and UNCo, with some campuses offering only the classroom side. Campuses missing from the list can be configured with environment variables for the base URLs.

Credentials can be stored in the system keychain through a `login` command or supplied as environment variables. It runs on your own computer over stdio, or as an HTTP server with OAuth. The README is in Spanish and has a separate guide for students who do not program.

## Features

- **Moodle classroom access:** Read course material, announcements, assignments and grades from the virtual classroom.
- **SIU Guaraní queries:** Check enrolments, passed finals, averages and exam sittings.
- **Confirmed actions:** Posting to forums or submitting assignments happens only with your confirmation.
- **Campus registry:** Many Argentine campuses are pre-mapped, and others can be added by URL.
- **Keychain login:** Credentials can be saved in the system keychain by a login command.
- **Local or HTTP:** Runs over stdio on your machine or as an HTTP server with OAuth.

## Good for

- Ask what you need to hand in this week
- Check a grade and the teacher's corrections on an assignment
- Summarise a unit guide from the classroom
- Look up exam sittings and your average in Guaraní
- Catch new announcements from teachers

## Install

### Claude Code (Terminal)

```sh
claude mcp add unimcp --env UNI_PASS='<UNI_PASS>' --env UNI_GUARANI_PASS='<UNI_GUARANI_PASS>' -- npx -y @nuwujix/unimcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "unimcp": {
      "command": "npx",
      "args": [
        "-y",
        "@nuwujix/unimcp"
      ],
      "env": {
        "UNI_PASS": "<UNI_PASS>",
        "UNI_GUARANI_PASS": "<UNI_GUARANI_PASS>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "unimcp": {
      "command": "npx",
      "args": [
        "-y",
        "@nuwujix/unimcp"
      ],
      "env": {
        "UNI_PASS": "<UNI_PASS>",
        "UNI_GUARANI_PASS": "<UNI_GUARANI_PASS>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "unimcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@nuwujix/unimcp"
      ],
      "env": {
        "UNI_PASS": "<UNI_PASS>",
        "UNI_GUARANI_PASS": "<UNI_GUARANI_PASS>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "unimcp": {
      "command": "npx",
      "args": [
        "-y",
        "@nuwujix/unimcp"
      ],
      "env": {
        "UNI_PASS": "<UNI_PASS>",
        "UNI_GUARANI_PASS": "<UNI_GUARANI_PASS>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "unimcp": {
      "command": "npx",
      "args": [
        "-y",
        "@nuwujix/unimcp"
      ],
      "env": {
        "UNI_PASS": "<UNI_PASS>",
        "UNI_GUARANI_PASS": "<UNI_GUARANI_PASS>"
      }
    }
  }
}
```

## FAQ

### Is it official?

No. The README says it is an unofficial server for Argentine universities.

### Where does it run?

On your own computer, or as an HTTP server with OAuth.

### How are my credentials handled?

They can be stored in your system keychain by the login command, or passed as environment variables.

### What if my campus is not listed?

Set the Moodle and Guaraní base URLs through UNI_AULA_BASE_URL and UNI_GUARANI_URL.

### Is UniMCP free?

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

### How do I add UniMCP to Claude Code?

Run this command in your terminal: claude mcp add unimcp --env UNI_PASS='<UNI_PASS>' --env UNI_GUARANI_PASS='<UNI_GUARANI_PASS>' -- npx -y @nuwujix/unimcp

### What are the best alternatives to UniMCP?

The closest alternatives to UniMCP are Penline Handwriting Sheets, Lumen, Education Mcp, Born Then and FreeDict.

## Where this comes from

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

## Alternatives

- [Penline Handwriting Sheets](https://ai-powered.com/mcp/penline-handwriting-sheets): Penline Handwriting Sheets is an MCP server for education and exams.
- [Lumen](https://ai-powered.com/mcp/lumen-4): Lumen is an open-source MCP server for education and exams.
- [Education Mcp](https://ai-powered.com/mcp/education-mcp): Education Mcp is a freemium MCP server for education and exams.
- [Born Then](https://ai-powered.com/mcp/born-then): Born Then is a free MCP server for education and exams.
- [FreeDict](https://ai-powered.com/mcp/freedict): FreeDict is a freemium MCP server for language learning.
- [Extraudinary](https://ai-powered.com/mcp/extraudinary): Extraudinary is a freemium MCP server for education and exams.
- [Scormbusters](https://ai-powered.com/mcp/scormbusters): Scormbusters is an MCP server for education and exams.
- [Dengdeng Chinese Dictionary](https://ai-powered.com/mcp/dengdeng-chinese-dictionary): Dengdeng Chinese Dictionary is a free MCP server for language learning.

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