Moodle + Obsidian
Moodle courses, grades and deadlines for AI assistants, synced into an Obsidian vault
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.8.3
- Listing updated
- today
Similar MCP servers
About Moodle + Obsidian
Moodle + Obsidian is an MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add moodle-obsidian-mcp --env MOODLE_TOKEN='<MOODLE_TOKEN>' -- uvx moodle-obsidian-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"moodle-obsidian-mcp": {
"command": "uvx",
"args": [
"moodle-obsidian-mcp"
],
"env": {
"MOODLE_TOKEN": "<MOODLE_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"moodle-obsidian-mcp": {
"command": "uvx",
"args": [
"moodle-obsidian-mcp"
],
"env": {
"MOODLE_TOKEN": "<MOODLE_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"moodle-obsidian-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"moodle-obsidian-mcp"
],
"env": {
"MOODLE_TOKEN": "<MOODLE_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"moodle-obsidian-mcp": {
"command": "uvx",
"args": [
"moodle-obsidian-mcp"
],
"env": {
"MOODLE_TOKEN": "<MOODLE_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"moodle-obsidian-mcp": {
"command": "uvx",
"args": [
"moodle-obsidian-mcp"
],
"env": {
"MOODLE_TOKEN": "<MOODLE_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
OBSIDIAN_VAULT_DIRObsidian vault folder where notes and materials are written.MOODLE_URLMoodle base URL (https). Optional if you log in with `moodle-mcp --login`.MOODLE_TOKENMoodle mobile web service token. Prefer `moodle-mcp --login`, which stores it with 0600 permissions.MOODLE_MCP_TOOLSToolsets to expose: core, grades, forums, obsidian, write, auth, raw, or all.MOODLE_MCP_LANGUAGELanguage of the generated notes.
Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- get_recent_changes
- Returns the last sync's change note without calling Moodle.
What it does
- 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
Pricing
Pricing unknown
Prices not published
Moodle + Obsidian 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.



