MinerU
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
Moodle for AI assistants, SSO included: courses, grades, deadlines and forums synced to Obsidian.
Texto original del autor
Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
A privacy-first app that strips AI watermarks from content you own.
Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 6/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 18/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala Moodle + Obsidian. Sigue https://mcp.popnx.com/i/carlosandreferreira-moodle-obsidian-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 17 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de Moodle + Obsidian (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Moodle + Obsidian para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "moodle-obsidian": { "command": "uvx", "args": [ "moodle-obsidian-mcp" ], "env": { "MOODLE_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MOODLE_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Moodle + Obsidian aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
SettingsDeveloperEdit Config
{
"mcpServers": {
"moodle-obsidian": {
"command": "uvx",
"args": [
"moodle-obsidian-mcp"
],
"env": {
"MOODLE_TOKEN": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Moodle + Obsidian y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Moodle + Obsidian o muestra una herramienta de Moodle + Obsidian en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
OBSIDIAN_VAULT_DIR Carpeta de la bóveda de Obsidian donde se escriben las notas y los materiales. MOODLE_URL URL base de Moodle (https). Es opcional si inicias sesión con moodle-mcp --login MOODLE_MCP_TOOLS Conjuntos de herramientas a exponer: core, grades, forums, obsidian, write, auth, raw o all. MOODLE_MCP_LANGUAGE Idioma de las notas generadas. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Moodle + Obsidian
Moodle + Obsidian se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar Moodle + Obsidian
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de Moodle + Obsidian (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Moodle + Obsidian para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user moodle-obsidian --env MOODLE_TOKEN=your-value -- uvx moodle-obsidian-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MOODLE_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Moodle + Obsidian aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user moodle-obsidian --env MOODLE_TOKEN=your-value -- uvx moodle-obsidian-mcpCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver Moodle + Obsidian en la lista como conectado
Usa Moodle + Obsidian y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Moodle + Obsidian o muestra una herramienta de Moodle + Obsidian en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
OBSIDIAN_VAULT_DIR Carpeta de la bóveda de Obsidian donde se escriben las notas y los materiales. MOODLE_URL URL base de Moodle (https). Es opcional si inicias sesión con moodle-mcp --login MOODLE_MCP_TOOLS Conjuntos de herramientas a exponer: core, grades, forums, obsidian, write, auth, raw o all. MOODLE_MCP_LANGUAGE Idioma de las notas generadas. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de Moodle + Obsidian (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Moodle + Obsidian para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "moodle-obsidian": { "command": "uvx", "args": [ "moodle-obsidian-mcp" ], "env": { "MOODLE_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MOODLE_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Moodle + Obsidian aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
En la configuración de Moodle + Obsidian, MOODLE_TOKEN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Moodle + Obsidian y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Moodle + Obsidian o muestra una herramienta de Moodle + Obsidian en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
OBSIDIAN_VAULT_DIR Carpeta de la bóveda de Obsidian donde se escriben las notas y los materiales. MOODLE_URL URL base de Moodle (https). Es opcional si inicias sesión con moodle-mcp --login MOODLE_MCP_TOOLS Conjuntos de herramientas a exponer: core, grades, forums, obsidian, write, auth, raw o all. MOODLE_MCP_LANGUAGE Idioma de las notas generadas. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de Moodle + Obsidian (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Moodle + Obsidian para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "moodle-obsidian": { "type": "stdio", "command": "uvx", "args": [ "moodle-obsidian-mcp" ], "env": { "MOODLE_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MOODLE_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Moodle + Obsidian aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
En la configuración de Moodle + Obsidian, MOODLE_TOKEN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Moodle + Obsidian y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Moodle + Obsidian o muestra una herramienta de Moodle + Obsidian en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
OBSIDIAN_VAULT_DIR Carpeta de la bóveda de Obsidian donde se escriben las notas y los materiales. MOODLE_URL URL base de Moodle (https). Es opcional si inicias sesión con moodle-mcp --login MOODLE_MCP_TOOLS Conjuntos de herramientas a exponer: core, grades, forums, obsidian, write, auth, raw o all. MOODLE_MCP_LANGUAGE Idioma de las notas generadas. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user moodle-obsidian --env MOODLE_TOKEN=your-value -- uvx moodle-obsidian-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"moodle-obsidian": {
"command": "uvx",
"args": [
"moodle-obsidian-mcp"
],
"env": {
"MOODLE_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"moodle-obsidian": {
"command": "uvx",
"args": [
"moodle-obsidian-mcp"
],
"env": {
"MOODLE_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"moodle-obsidian": {
"type": "stdio",
"command": "uvx",
"args": [
"moodle-obsidian-mcp"
],
"env": {
"MOODLE_TOKEN": "your-value"
}
}
}
}OBSIDIAN_VAULT_DIR envMOODLE_URL envMOODLE_TOKEN secreto obligatorio envMOODLE_MCP_TOOLS envMOODLE_MCP_LANGUAGE envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
pypi: moodle-obsidian-mcpSegún cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub CarlosAndreFerreira, dueña del repo
Último cambio de código: hace 3 días
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Aún no revisado
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/carlosandreferreira-moodle-obsidian-mcp)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: MOODLE_TOKEN
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 3 días, y la última versión (0.8.3) llegó al registro hace 3 días.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.
En la misma categoría: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.
| Este Moodle + Obsidian | Puter MCP | XcodeBuildMCP | Vexa | Atlassian Rovo MCP Server | Anki MCP Server | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Se instala en tu equipo |
| Necesita clave | Sí | No | No | Sí | No | No |
| Se añade con + en Claude | No | No | No | No | Sí | No |
| Revisiones básicas | 3/3 | 4/4 | 3/3 | 2/4 | 4/4 | 3/3 |
| Licencia | MIT | AGPL-3.0 | MIT | Apache-2.0 | Apache-2.0 | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
A Model Context Protocol server that gives AI assistants (Claude, opencode, any MCP client) safe access to Moodle, and syncs your courses, grades, deadlines and materials into an Obsidian vault.
Works with any Moodle that has Web Services and the mobile app service enabled — including universities behind federated SSO (Entra ID, SAML, Shibboleth, CAS), where students can't generate an API token by hand.
Most MCP servers for third-party platforms pipe untrusted content straight into the model and expose every write action by default. Moodle is a worst case for that: any participant in a course can write forum posts the model will read, and actions like submitting an assignment can't be undone. This server is designed around that threat model:
readOnlyHint, so a client can auto-approve them without auto-approving anything irreversible.display:none, font-size:0, hidden, HTML comments, Unicode tag characters, zero-width and bidi control characters — so the model reads what the student sees;dataviewjs/dataview blocks, inline Dataview and Templater commands are neutralised, remote images become links (no tracking pixels);pluginfile.php URLs on the configured instance; any other host is refused before a request is made. Tools that can overwrite credentials are off by default, so a malicious forum post can't swap your token.moodle-mcp --login starts the mobile-app login in your browser with a single-use passport; a moodlemobile:// URL handler receives the redirect, checks Moodle's signature and stores the token (0600). Registered natively on Linux (xdg-mime), Windows (HKEY_CURRENT_USER, no admin) and macOS (an AppleScript applet registered with Launch Services). The token never passes through the model, and the handler moves the URL out of its command-line arguments at once, so other local users can't read it with ps.get_recent_changes returns it, without calling Moodle): new grades, changed deadlines, new assignments and quizzes, new materials, new forum topics and topics with new replies..ics calendar next to the dashboard (import or subscribe in Google Calendar, Outlook, Thunderbird or your phone; a reminder the day before), and an Obsidian Tasks list (- [ ] … 📅 YYYY-MM-DD) in the dashboard.moodle-mcp --schedule 6 syncs every 6 hours with the OS scheduler (systemd timer, launchd or Windows Task Scheduler), no MCP client running. moodle-mcp --sync runs one sync now.moodle-mcp --set language=en switches the text of every generated note; folders stay put.moodle://changes, moodle://deadlines and moodle://dashboard serve the last sync without calling Moodle; the weekly_review, prepare_assignment and forum_catch_up prompts are ready-made flows. The Vault tools return typed structured output (outputSchema)..pdf.md that agents can read (optional [pdf] extra).instance parameter is exposed as an enum in the schema, so the model gets the valid names instead of free text.The package is on PyPI as moodle-obsidian-mcp; it installs two commands, moodle-mcp and moodle-mcp-token-catcher.
uv tool install "moodle-obsidian-mcp[pdf]" # or: pipx install "moodle-obsidian-mcp[pdf]"
moodle-mcp --install-handler # once: register the moodlemobile:// handler moodle-mcp --login # log in through your browser (SSO works)
Upgrade with uv tool upgrade moodle-obsidian-mcp (or pipx upgrade moodle-obsidian-mcp).
Use a permanent install (uv tool or pipx) rather than uvx: the login handler is registered with the executable's path, and uvx runs from a cache that can be wiped. To try it without installing:
uvx --from moodle-obsidian-mcp moodle-mcp --show-config
From a clone, ./install.sh [vault-path] does the permanent install, sets the vault, registers the handler and tells you to run moodle-mcp --login. For development, see Development.
The [pdf] extra adds PDF text extraction via PyMuPDF. It's kept out of the base install because PyMuPDF is AGPL-3.0; without it everything works, PDF downloads just don't get the companion .md.
moodle-mcp --uninstall-handler removes the moodlemobile:// handler again.
%% moodle-mcp:start %% and %% moodle-mcp:end %%; anything you write outside that block, and any frontmatter properties you add, survive every sync. A note from an older version (without the markers) is copied to .moodle-mcp/backup/ in the vault before its first rewrite.timemodified and size are recorded in .moodle-mcp/state- .json in the vault; files that haven't changed in Moodle and are still in the vault aren't downloaded again.errors with status: "partial". Only a missing or invalid token stops everything, with instructions to log in again.isError in MCP), with the cause and what to do, instead of being disguised as results. (2), (3)…; filenames are valid on Windows, macOS and Linux.Retry-After); writes are never retried once the server has received them, so nothing gets posted twice. Connections are reused (keep-alive).MOODLE_MCP_SYNC_SUBDIR puts the dashboard and course notes in a subfolder (links follow); MOODLE_MCP_DASHBOARD_NAME renames the dashboard. With several instances, each gets its own dashboard.MOODLE_MCP_MAX_DOWNLOAD_MB (500).audit.log (0600, in the config directory) with its outcome — confirmed, refused, or run without confirmation — with no tokens and rotation at 1 MB.get_course_participants returns only id, name, roles and groups; classmates' emails and profile data never reach the LLM provider.credentials.json and last_auth.log are written atomically and already 0600; an unreadable credentials.json is set aside rather than deleted; moodle-mcp --show-config (and startup) warn about files readable by other users.Nothing is required — every option has a default. Configuration is layered, highest precedence first:
env in Claude, environment in opencode).0600.The config directory follows the OS: ~/.config/moodle-mcp (Linux), ~/Library/Application Support/moodle-mcp (macOS), %LOCALAPPDATA%\moodle-mcp (Windows). It doesn't live next to the code because under uvx/pipx the package runs from an ephemeral, possibly read-only cache.
moodle-mcp --show-config # where everything is read from, secrets redacted
moodle-mcp --list-toolsets # which tools each toolset exposes moodle-mcp --set sync_subdir=Moodle --set instances.utad.url=https://e-learning.utad.pt moodle-mcp --set language=en # note text in English (default: pt)
Note options: language (pt/en), dashboard_name (default: an existing Doutoramento - Painel Moodle note, else Painel Moodle/Moodle Dashboard), courses_dir (default Unidades Curriculares), sync_subdir.
moodle-mcp --sync # sync every instance with a token, now
moodle-mcp --schedule 6 # every 6 hours (1–24); add --materials to download files too moodle-mcp --unschedule
The task runs moodle-mcp --sync and reads the same config.toml and credentials.json; no token goes into the task files or the command line. The scheduler doesn't see your shell or MCP client environment, so put the vault in config.toml (moodle-mcp --set obsidian_vault_dir=…) rather than only in the client's env. The result of the last run is in last_sync.log, in the config directory.
default_instance = "uab"
[instances.uab] url = "https://elearning.uab.pt"
[instances.utad] url = "https://e-learning.utad.pt"
or via environment: MOODLE_ _URL and MOODLE_ _TOKEN.
Unnamed MOODLE_URL / MOODLE_TOKEN still work as the default instance, but only while no named instance exists — otherwise one university's token could be sent to another's server.
--tools | Tools | ~tokens | Writes to Moodle |
|---|---|---|---|
| (default) | 22 | ~5,500 | no |
core,grades,forums,obsidian,write | 29 | ~7,900 | yes |
all | 33 | ~9,700 | yes, plus the raw API |
core,obsidian | 13 | ~3,700 | no |
core | 8 | ~1,750 | no |
core is always included. write and raw log a warning at startup. auth (tools that sto