# Moodle + Obsidian

> Moodle + Obsidian is an MCP server for knowledge and memory. Moodle courses, grades and deadlines for AI assistants, synced into an Obsidian vault. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/carlosandreferreira/moodle-obsidian-mcp
- **MCP Registry name:** io.github.CarlosAndreFerreira/moodle-obsidian-mcp
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory), [education and exams](https://ai-powered.com/categories/education-and-exams)
- **Listing updated:** 2026-11-18

## About

It is built around the idea that Moodle is a risky source for a model, since any course participant can write forum posts the model will read and some actions cannot be undone. Write tools such as submissions, forum posts and messages are off by default, 18 of the 22 default tools carry read-only hints, and every write asks for confirmation showing the exact recipient and text.

Server-side defences strip hidden content such as display:none text, zero-width characters and HTML comments from Moodle responses, neutralise Dataview and Templater code in notes written to the vault, and refuse to send the token to any host except the configured instance. Credentials never appear in tool responses.

The login helper captures an SSO token through the Moodle mobile-app flow, so it works at universities with Entra ID, SAML, Shibboleth or CAS. A sync writes a dashboard, per-course notes, an ICS calendar of deadlines and a what-changed note, and can run on a schedule. Notes can be in English or Portuguese, and the README counts 33 tools across the platform.

## Features

- **Read-only defaults:** Writes and raw API access are off unless enabled.
- **SSO token capture:** Logs in via the browser without generating a token by hand.
- **Obsidian dashboard:** Notes for each course with grades, deadlines and materials.
- **Change tracking:** Notes new grades, deadlines and topics since last sync.
- **Calendar export:** An .ics file of deadlines.
- **Scheduled sync:** Runs from the OS scheduler.

## Good for

- Keep a course dashboard in Obsidian
- Get alerts on changed deadlines
- Draft a weekly review from grades
- Catch up on forum activity

## Install

### Claude Code (Terminal)

```sh
claude mcp add moodle-obsidian-mcp --env MOODLE_TOKEN='<MOODLE_TOKEN>' -- uvx moodle-obsidian-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "moodle-obsidian-mcp": {
      "command": "uvx",
      "args": [
        "moodle-obsidian-mcp"
      ],
      "env": {
        "MOODLE_TOKEN": "<MOODLE_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "moodle-obsidian-mcp": {
      "command": "uvx",
      "args": [
        "moodle-obsidian-mcp"
      ],
      "env": {
        "MOODLE_TOKEN": "<MOODLE_TOKEN>"
      }
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "moodle-obsidian-mcp": {
      "command": "uvx",
      "args": [
        "moodle-obsidian-mcp"
      ],
      "env": {
        "MOODLE_TOKEN": "<MOODLE_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "moodle-obsidian-mcp": {
      "command": "uvx",
      "args": [
        "moodle-obsidian-mcp"
      ],
      "env": {
        "MOODLE_TOKEN": "<MOODLE_TOKEN>"
      }
    }
  }
}
```

## Tools

- `get_recent_changes`: Returns the last sync's change note without calling Moodle.

## FAQ

### Does it work with SSO?

Yes, including Entra ID, SAML, Shibboleth and CAS.

### Can it post on my behalf?

Only if write tools are enabled, and each write needs confirmation.

### What does it install via?

PyPI, as moodle-obsidian-mcp.

### How do I add Moodle + Obsidian to Claude Code?

Run this command in your terminal: claude mcp add moodle-obsidian-mcp --env MOODLE_TOKEN='<MOODLE_TOKEN>' -- uvx moodle-obsidian-mcp

### What are the best alternatives to Moodle + Obsidian?

The closest alternatives to Moodle + Obsidian are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and NeuroStack.

## Where this comes from

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

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [NeuroStack](https://ai-powered.com/mcp/neurostack): NeuroStack is a freemium MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Digitalnz](https://ai-powered.com/mcp/digitalnz): Digitalnz is a freemium MCP server for knowledge and memory.
- [Wikimedia Rest](https://ai-powered.com/mcp/wikimedia-rest): Wikimedia Rest is a freemium MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/moodle-obsidian
