What is MCP-Moodle
MCP-Moodle lets an AI assistant build and manage your Moodle by chat. You describe what you want in plain English, and real pages, quizzes, forums, courses and grades appear in your live Moodle site.
The two pieces
The project is deliberately split in two, joined by a single web service token:
- The Moodle plugin (
local_mcpbridge) adds the activity-creation web service functions that Moodle core is missing: create a quiz, add a question, create a page, forum, assignment, and more. 17 functions in total. - The MCP server (
moodle-mcp, Python) wraps Moodle's own read/write APIs and the plugin's new functions, and exposes all of them as 88 typed tools that any MCP client can call.
The mental model
you talk MCP server Moodle
-------- --tools--> -------- --REST--> -------
"add a quiz" 88 typed tools real records created
You type a request. The AI chooses the right tool, the server calls Moodle's REST API with your token, and Moodle creates real records. Nothing is simulated.
Why it exists
Moodle's built-in web services can create courses and users, but they cannot create activities (quizzes, pages, forums). The plugin fills that gap using Moodle's official add_moduleinfo() helper, so it stays upgrade-safe and never writes raw database tables.
What it can't do
It builds content inside Moodle, not Moodle itself. It cannot:
- Create or install Moodle plugins, new activity types, blocks, themes or auth methods.
- Write files or run code on the server.
- Reach anything outside Moodle's REST web service API.
The one plugin involved, local_mcpbridge, is installed once by an admin. The AI uses it; it does not build it.
Where to go next
- Requirements then the five Setup steps.
- Examples & recipes for copy-ready prompts.
- Tool reference for the full list.