Metadata-Version: 2.4
Name: moodle-mcp
Version: 0.1.0
Summary: A Model Context Protocol (MCP) server implementation that provides capabilities to interact with Moodle LMS.
Project-URL: Homepage, https://github.com/loyaniu/moodle-mcp
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: glom>=24.11.0
Requires-Dist: mcp[cli]>=1.6.0
Requires-Dist: python-dotenv>=1.1.0
Requires-Dist: requests>=2.32.3

# Moodle-MCP

> A Model Context Protocol (MCP) server implementation that provides capabilities to interact with Moodle LMS.
>
> **Warning:** This project is still in development, only some functions are available.

## Features

- [x] Get upcoming events from Moodle

## API Reference

For available Moodle API functions, please refer to the [official documentation](https://docs.moodle.org/dev/Web_service_API_functions).

## Setup Instructions

1. Create your own `.env` file from `.env.example`
2. Assume you have `uv` installed, run `uv add "mcp[cli]"` to install the MCP CLI tools
3. Run `mcp install server.py -f .env` to add the moodle-mcp server to Claude app

## Authentication

### Getting your Moodle token

1. Navigate to your Moodle token management page `https://{your-moodle-url}/user/managetoken.php`
2. Use the token with `Moodle mobile web service` in the `Service` column
3. Add this token to your `.env` file
