moodle-mcp

Give Claude full access to your Moodle — courses, files, assignments, grades, quizzes, calendar, and more. Build Obsidian study vaults from your lecture notes in one command.

13 tools · 5 prompts · MCP Resources

---

Quick Start

1. Install

npx moodle-mcp

Or install globally:

npm install -g moodle-mcp

2. Get your token → see below

3. Add to your MCP client

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on Mac, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "moodle": {
      "command": "npx",
      "args": ["moodle-mcp"],
      "env": {
        "MOODLE_URL": "https://moodle.yourschool.edu",
        "MOODLE_TOKEN": "your_token_here"
      }
    }
  }
}

VS Code (add to .vscode/mcp.json):

{
  "servers": {
    "moodle": {
      "command": "npx",
      "args": ["moodle-mcp"],
      "env": {
        "MOODLE_URL": "https://moodle.yourschool.edu",
        "MOODLE_TOKEN": "your_token_here"
      }
    }
  }
}

---

Getting Your Token

Option A — Moodle profile page (works everywhere)

1. Log in to your school's Moodle in a browser
2. Go to Profile → Security keys (URL: https://moodle.yourschool.edu/user/managetoken.php)
3. Find the Moodle mobile web service token and copy it
4. Set MOODLE_TOKEN=<token> in your MCP config

Option B — Username + password (not SSO schools)

If your school uses a regular username/password (not Microsoft/Google/SSO), you can skip the token step entirely:

"env": {
  "MOODLE_URL": "https://moodle.yourschool.edu",
  "MOODLE_USERNAME": "your_username",
  "MOODLE_PASSWORD": "your_password"
}

⚠️ SSO schools: If your school login page redirects to Microsoft, Google, or another identity provider, Option B won't work. Use Option A or C.

Option C — Extract from Moodle mobile app (SSO schools)

1. Install the Moodle app on your phone and log in with SSO
2. Go to App settings → About
3. Tap the version number 5 times to enable developer mode
4. Go to Developer options → Copy token and copy it
5. Use that token as MOODLE_TOKEN in Option A

---

Tools

Tool	Description	Params
moodle_get_site_info	School name, Moodle version, which APIs are enabled	—
moodle_list_courses	All your enrolled courses	—
moodle_get_course	Sections and all activities in a course	courseId
moodle_list_resources	Files and links, grouped by course section	courseId
moodle_list_assignments	Assignments with due dates, grouped by section	courseId
moodle_get_assignment	Submission status and grade feedback	assignmentId
moodle_get_grades	Full grade report with categories and feedback	courseId
moodle_get_calendar_events	Upcoming events across courses	courseId?, daysAhead?
moodle_list_quizzes	Quizzes with time limits and open dates	courseId
moodle_get_quiz_attempts	Your past attempt grades and states	quizId
moodle_list_forums	Forum activities in a course	courseId
moodle_get_forum_discussions	Recent discussions in a forum	forumId
moodle_get_notifications	Recent notifications (grades, feedback, replies)	limit?

---

Prompts

Use these in any MCP client that supports prompts (Claude Desktop, VS Code with Copilot, etc.):

Prompt	Use case	Example
summarize-course	Full course overview organized by section	/summarize-course courseId=42
whats-due	Prioritized due dates this week / next week	/whats-due or /whats-due courseId=42
build-study-notes	Build a linked Obsidian vault from course materials	/build-study-notes courseId=42 vaultPath=~/obsidian/finals
exam-prep	Topic-by-topic study guide based on grades and quiz results	/exam-prep courseId=42
search-notes	Natural language search across all course files	/search-notes courseId=42 query="derivatives and limits"

---

Obsidian Finals Prep

Turn your entire semester into a linked knowledge graph in one command.

Setup

1. Install Obsidian (free, works on Mac/Windows/Linux)
2. Create a new vault, e.g. ~/obsidian/finals
3. Make sure moodle-mcp is connected to your MCP client

Build the vault

Use the /build-study-notes prompt in Claude Desktop:

/build-study-notes courseId=42 vaultPath=~/obsidian/finals

Or paste this directly into Claude:

Pull my [Course Name] (course ID 42), read all the lecture notes and slides,
and build a linked Obsidian vault at ~/obsidian/finals — one note per topic,
with [[wikilinks]] between related concepts, a MOC.md index, and tags for each section.

Claude will:

1. Pull all your course sections, files, assignments, and grades
2. Read each PDF and document directly via the MCP resources protocol
3. Write one .md file per section with key concepts, definitions, and examples
4. Add [[wikilinks]] between related terms across notes
5. Create a MOC.md (Map of Content) index linking everything

See the graph

1. Open the vault in Obsidian
2. Click Graph View (sidebar icon or Cmd+G)
3. Your entire course appears as a knowledge graph — linked concepts cluster together, isolated topics stand out as things to review

Natural language search

Once the vault is built, you can ask Claude to find specific content:

/search-notes courseId=42 query="the central limit theorem and when to use it"

Claude will look through all your course materials, find the relevant files, read them, and synthesize a direct answer.

---

Compatibility

Some tools require your Moodle admin to enable specific web services. Run moodle_get_site_info to see which tools are available on your school's Moodle.

Tool	Required	Notes
moodle_list_courses, moodle_get_course, moodle_list_resources	Always available	Core Moodle WS
moodle_list_assignments, moodle_get_assignment	Admin must enable	mod_assign service
moodle_get_grades	Admin must enable	gradereport_user service
moodle_get_calendar_events	Usually available	core_calendar service
moodle_list_quizzes, moodle_get_quiz_attempts	Admin may need to enable	mod_quiz service
moodle_get_forum_discussions	Admin may need to enable	mod_forum service
moodle_get_notifications	Admin may need to enable	message_popup service

If a tool isn't available, it returns a helpful message explaining what your admin needs to enable — it won't crash the server.

---

Contributing

Issues and PRs welcome. Open an issue first for large changes.

MIT License — © 2026 Alexandre Ribeiro