Skip to main content

Moodle MCP

CI Release License: MIT

MCP server that lets AI agents use a Moodle account: courses, deadlines, grades, files and homework submissions.

Requirements

  • Linux, Python 3.10+, ~/.local/bin on PATH
  • A Moodle site that allows the Moodle app
  • Any MCP client: Claude Code, Codex, Copilot CLI, Cursor, …

Install

git clone https://github.com/MattFor/moodle-mcp
cd moodle-mcp
./install --all
moodle-mcp login moodle.example.edu

--all registers the server with the clients above that it finds. For any other client, add a stdio server with the command moodle-mcp. login signs in through your browser, or asks for your password if the site signs in that way.

Or from PyPI, then register it with your client yourself:

uv tool install moodle-mcp-server   # or: pipx install moodle-mcp-server
claude mcp add --scope user moodle -- moodle-mcp
moodle-mcp login moodle.example.edu

Installed this way, the browser cannot hand the sign-in back by itself: copy the "launch the app" link from the sign-in page and paste it into login.

Usage

Ask your agent what is due this week, or to hand in report.pdf for an assignment. Reading (moodle_read) and changing (moodle_write) are separate tools, so you can let it read freely and approve every change. When the site expires the key, run login again.

Removal

claude mcp remove --scope user moodle; codex mcp remove moodle; copilot mcp remove moodle
rm -r ~/.local/bin/moodle-mcp ~/.local/share/applications/moodle-mcp.desktop ~/.config/moodle-mcp ~/.cache/moodle-mcp

Remove moodle from ~/.cursor/mcp.json if you use Cursor. Installed from PyPI, run uv tool uninstall moodle-mcp-server (or pipx uninstall moodle-mcp-server) instead of removing ~/.local/bin/moodle-mcp.

License

MIT, see LICENSE. By MattFor.

Metadata

Release files for moodle-mcp-server 1.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for moodle-mcp-server 1.0.3
File Size Uploaded Provenance Actions
moodle_mcp_server-1.0.3.tar.gz 9.8 kB With provenance Details for moodle_mcp_server-1.0.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for moodle-mcp-server 1.0.3
File Interpreter ABI Platform Actions
moodle_mcp_server-1.0.3-py3-none-any.whl Python 3 none any Details for moodle_mcp_server-1.0.3-py3-none-any.whl

Total release size: 19.8 kB

Release files / moodle_mcp_server-1.0.3.tar.gz

Download URL moodle_mcp_server-1.0.3.tar.gz
Size 9.8 kB
Tags Source
SHA-256 checksum
How to use checksums
18742c15a4de628b6a91834640704dee72b85fc0825e1a38369bf49a5a7a71fd
BLAKE2b-256 checksum
How to use checksums
334743f7fed1b51848ba3ab1255116dce19b5d3134b15ff2690588a7f99d954f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Release files / moodle_mcp_server-1.0.3-py3-none-any.whl

Download URL moodle_mcp_server-1.0.3-py3-none-any.whl
Size 10.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8d30a6c9000471b5bf9a2154a3d11d5f58258cde779b53b06e8414520e6abba6
BLAKE2b-256 checksum
How to use checksums
8aa764d0e4287edfd2c709ee318ab1d14ba88d154976c086081502d88401aeef
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Security for moodle-mcp-server 1.0.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for moodle_mcp_server-1.0.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.3 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page