MCP Server · Moodle

Moodle

Ask Claude what’s due, how you did and what changed in your courses. It reads your Moodle through the official app interface and downloads course files for you. Read-only: it never submits or posts anything.

For Claude

Download ZIP View on GitHub

Install

  1. Open Claude CodeIn the Claude desktop app, open the Code tab. Regular chats can’t install software on your computer.
  2. Paste this promptClaude installs everything and opens Moodle in your browser.
    Install the Moodle MCP server for me by following https://raw.githubusercontent.com/EmreAI/claude-mcp/main/moodle-mcp/INSTALL_WITH_CLAUDE.md. My Moodle is https://moodle.novasbe.pt
  3. Log in and copy the linkLog in to Moodle as usual. On the page with the Continue button, don’t click it, because it’s meant for the Moodle phone app. Right-click it and copy the link. Claude picks it up by itself and finishes the setup.
  4. Restart ClaudeQuit and reopen the desktop app, then ask: “What’s due in Moodle this week?”

Claude reads the copied link from your clipboard and then clears it, so your login never appears in the chat. Needs Python 3.10 or newer; Claude asks before installing it. Not at Nova SBE? Change the address in the prompt.

Try it

What’s new in my Moodle courses since last week?
Which assignments are due in the next two weeks, and have I submitted them?
Show my grades and the feedback on my last assignment.
Download all files from Week 3 of my marketing course.

What it does

01See what’s newNew and changed files, activities and forum posts across all your current courses, in one list.
02Deadlines and submissionsUpcoming deadlines, calendar events and assignments, with whether you’ve already submitted.
03Grades and feedbackYour grades per course, teacher comments and feedback files, quiz attempts and reviews.
04Download course filesOne file, a whole section such as “Week 2”, a folder or the full course, sorted into folders. Files you already have are skipped.
05Read course contentPages, books, labels, links and forum discussions, so Claude can summarise or explain them.
06Notifications and messagesMoodle notifications, your conversations and course progress, without opening Moodle.

Your data

  1. Read-onlyIt reads courses, grades and messages. It can’t submit assignments, post in forums or send messages.
  2. Token stays localYour Moodle token is saved only in your Claude config, never in the download or on GitHub. Treat it like a password.
  3. Only your Moodle siteRequests and downloads go only to the Moodle address you set. Files land in ~/Downloads/Moodle.

What’s inside

  • moodle-mcp/The server folder
  • server.pyThe MCP server and its 21 tools
  • get_token.pyLogs you in and adds the server to Claude
  • INSTALL_WITH_CLAUDE.mdThe steps Claude follows to install it
  • requirements.txtThe two Python packages it needs
  • README.mdSetup guide and full tool list