The right file, at last.
List your courses and search for a document by name. One specific handout, without downloading the whole semester.
The little companion connecting Moodle to your assistant. Find a handout, look up an assignment, stay on track. Just like that.
On your Mac, on Linux or on a VPS. Your choice.
Found it in your calculus course. Ready to get started?
Moodle has your courses. Your assistant has the conversation. MCP brings them together.
List your courses and search for a document by name. One specific handout, without downloading the whole semester.
Share extracted text from a PDF you choose with your assistant. Up to 12,000 characters to start the conversation.
Download from the CLI. With the optional Mac client, receive files from your VPS in your own folders too.
Setup asks for your university’s Moodle URL, opens the sign-in page and helps configure the tunnel. No Moodle token needed.
See requirements and setup steps →# Python 3.11+ · macOS / Linux $ git clone https://github.com/edouaz/moodle-mcp.git $ cd moodle-mcp $ bash setup.sh
Sign in yourself through your university’s browser flow. Your session stays on your machine; you choose which resources to share with your assistant.
Understand what gets shared →Local stdio or an outbound OpenAI tunnel. No public MCP server to expose.
Your usual SSO and MFA. No course changes or assignment submissions.
The code is public. Your cookies and keys stay local. Keep your tunnel personal.
An idea, a different Moodle theme, a bug to fix? Contributions are welcome.
Say hello on GitHub ↗