Skip to content
Back to search

educ8

Custom ItsLearning client & MCP server

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 20 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Oliverkempel/educ8 with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Oliverkempel/educ8'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/oliverkempel--educ8/badge.svg)](/listings/oliverkempel--educ8)

HTML

<a href="/listings/oliverkempel--educ8"><img src="/api/listings/oliverkempel--educ8/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Install

Download the latest release from the repository's **Releases** page:

| You want | Download | |---|---| | The Linux app (includes `educ8-mcp`) | `educ8-<version>-x86_64.flatpak`, then `flatpak install --user educ8-<version>-x86_64.flatpak`; or `educ8_<version>_amd64.snap`, then `sudo snap install --dangerous educ8_<version>_amd64.snap && sudo snap connect educ8:educ8-data`; or `educ8-<version>-linux-x64.tar.gz`, then unpack it and run `./install.sh` | | Only the MCP server | `educ8-mcp-<version>-<platform>` (Linux, Windows, macOS; one self-contained file) |

The tar.gz needs GTK 4, libadwaita and WebKitGTK 6.0. On Ubuntu: `sudo apt install libgtk-4-1 libadwaita-1-0 libwebkitgtk-6.0-4`. The Flatpak and the snap bring their own. arm64 builds exist for all three. The macOS and Windows builds of the MCP server aren't signed yet: on macOS run `xattr -d com.apple.quarantine educ8-mcp` once.

2. Configure

Create `~/.local/share/Educ8/config.json` (Windows: `%LOCALAPPDATA%\Educ8\config.json`) with your school's itslearning site and an itslearning OAuth client id:

{
  "BaseUrl": "https://yourschool.itslearning.com",
  "ClientId": "<your client id>"
}

The client id must be registered with itslearning for the redirect URI `itsl-itslearning://login`.

3. Sign in

Open **Educ8** and choose **Sign in with itslearning**. That's it.

Without the app, run `educ8-mcp login` and sign in in the browser. To let the browser finish the login by itself, register the link handler once with `educ8-mcp register-url-handler` (Linux, Windows); otherwise paste the final `itsl-itslearning://…` link into the terminal.

4. Connect Claude

Claude Desktop: add the server to `~/.config/Claude/claude_desktop_config.json` (Settings → Developer → Edit Config) and restart Claude:

{
  "mcpServers": {
    "itslearning": { "command": "/home/<you>/.local/opt/educ8/educ8-mcp" }
  }
}

Use the path to `educ8-mcp` from your install: tar.gz `~/.local/opt/educ8/educ8-mcp`, or the file you downloaded. For the snap, use `/snap/bin/educ8.educ8-mcp`. For the Flatpak, use `"command": "flatpak"` with `"args": ["run", "--command=educ8-mcp", "io.github.educ8.Educ8"]`.

Claude Code: `claude mcp add itslearning -- <path to educ8-mcp>`.

Then ask things like *"What do I have this week?"*, *"Summarize this week's lecture slides in Statistics"* or *"What's new in my courses?"*.

5. Control what the AI can do

In the app, open **MCP server**:

- **Allow changes in itslearning:** off by default. When on, the AI can hand in assignments. It always shows a preview and asks first. - **Tools:** turn single tools off. They disappear for the AI right away. - **Status and recent activity:** which AI apps are connected and what they called.

Changes apply immediately, also to running servers. Without the app: `educ8-mcp write-actions on|off`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 108 lines
  1. # Educ8
  2. A native desktop app and an MCP server for the itslearning learning platform.
  3. - **Desktop app** (Linux, GTK 4 + libadwaita): your courses, course pages with plans and resources, a week calendar with lesson plans and material. Files open in your default apps.
  4. - **MCP server** (`educ8-mcp`): lets AI assistants like Claude read your courses, material (PDF, Office files, images, …), schedule, assignments and what's new. It's read-only unless you allow changes.
  5. - Both share one login. The app's **MCP server** page shows which AI apps are connected, turns tools on and off, and lists recent tool calls.
  6. Windows and macOS apps are planned. The MCP server already runs on all three.
  7. ## Getting started
  8. ### 1. Install
  9. Download the latest release from the repository's **Releases** page:
  10. | You want | Download |
  11. |---|---|
  12. | The Linux app (includes `educ8-mcp`) | `educ8-<version>-x86_64.flatpak`, then `flatpak install --user educ8-<version>-x86_64.flatpak`; or `educ8_<version>_amd64.snap`, then `sudo snap install --dangerous educ8_<version>_amd64.snap && sudo snap connect educ8:educ8-data`; or `educ8-<version>-linux-x64.tar.gz`, then unpack it and run `./install.sh` |
  13. | Only the MCP server | `educ8-mcp-<version>-<platform>` (Linux, Windows, macOS; one self-contained file) |
  14. The tar.gz needs GTK 4, libadwaita and WebKitGTK 6.0. On Ubuntu: `sudo apt install libgtk-4-1 libadwaita-1-0 libwebkitgtk-6.0-4`. The Flatpak and the snap bring their own. arm64 builds exist for all three. The macOS and Windows builds of the MCP server aren't signed yet: on macOS run `xattr -d com.apple.quarantine educ8-mcp` once.
  15. ### 2. Configure
  16. Create `~/.local/share/Educ8/config.json` (Windows: `%LOCALAPPDATA%\Educ8\config.json`) with your school's itslearning site and an itslearning OAuth client id:
  17. ```json
  18. {
  19. "BaseUrl": "https://yourschool.itslearning.com",
  20. "ClientId": "<your client id>"
  21. }
  22. ```
  23. The client id must be registered with itslearning for the redirect URI `itsl-itslearning://login`.
  24. ### 3. Sign in
  25. Open **Educ8** and choose **Sign in with itslearning**. That's it.
  26. Without the app, run `educ8-mcp login` and sign in in the browser. To let the browser finish the login by itself, register the link handler once with `educ8-mcp register-url-handler` (Linux, Windows); otherwise paste the final `itsl-itslearning://…` link into the terminal.
  27. ### 4. Connect Claude
  28. Claude Desktop: add the server to `~/.config/Claude/claude_desktop_config.json` (Settings → Developer → Edit Config) and restart Claude:
  29. ```json
  30. {
  31. "mcpServers": {
  32. "itslearning": { "command": "/home/<you>/.local/opt/educ8/educ8-mcp" }
  33. }
  34. }
  35. ```
  36. Use the path to `educ8-mcp` from your install: tar.gz `~/.local/opt/educ8/educ8-mcp`, or the file you downloaded. For the snap, use `/snap/bin/educ8.educ8-mcp`. For the Flatpak, use `"command": "flatpak"` with `"args": ["run", "--command=educ8-mcp", "io.github.educ8.Educ8"]`.
  37. Claude Code: `claude mcp add itslearning -- <path to educ8-mcp>`.
  38. Then ask things like *"What do I have this week?"*, *"Summarize this week's lecture slides in Statistics"* or *"What's new in my courses?"*.
  39. ### 5. Control what the AI can do
  40. In the app, open **MCP server**:
  41. - **Allow changes in itslearning:** off by default. When on, the AI can hand in assignments. It always shows a preview and asks first.
  42. - **Tools:** turn single tools off. They disappear for the AI right away.
  43. - **Status and recent activity:** which AI apps are connected and what they called.
  44. Changes apply immediately, also to running servers. Without the app: `educ8-mcp write-actions on|off`.
  45. ## Settings
  46. All settings live in `config.json` (above). Environment variables override them.
  47. | Setting | `config.json` | Environment |
  48. |---|---|---|
  49. | Site | `BaseUrl` (required) | `ITSLEARNING_BASE_URL` |
  50. | Client id | `ClientId` (required) | `ITSLEARNING_CLIENT_ID` |
  51. | Allow changes | `AllowWriteActions` | `EDUC8_ALLOW_WRITE_ACTIONS` |
  52. | Turned-off tools | `DisabledTools` | |
  53. | Data folder | | `EDUC8_DATA_DIR` |
  54. The data folder holds the login (`tokens.json`, readable only by you), settings and the MCP activity log. Nothing leaves your machine except calls to itslearning.
  55. ## Build from source
  56. Needs the .NET 10 SDK (and the GTK libraries above for the app).
  57. ```bash
  58. dotnet build Educ8.slnx
  59. dotnet test Educ8.slnx
  60. dotnet run --project src/Educ8.App.Gtk # the app
  61. dotnet run --project src/Educ8.Mcp.Server # the MCP server (stdio); `-- --help` for commands
  62. ```
  63. Pull requests are built and tested by GitHub Actions; when one lands in `main`, a release is built. Versions are dates: `2026.11.19`, then `2026.11.19.1` for a later release that day. `packaging/flatpak/build-local.sh` builds the Flatpak locally.
  64. ## Project layout
  65. | Path | What |
  66. |---|---|
  67. | `src/Educ8.Itslearning` | itslearning core: login, tokens, REST client, file downloads |
  68. | `src/Educ8.Documents` | Files → Markdown and images (PDF, Office, text, images, zip) |
  69. | `src/Educ8.Mcp`, `src/Educ8.Mcp.Server` | MCP tools and the `educ8-mcp` host and CLI |
  70. | `src/Educ8.App.Core` | Desktop app view models, shared by every platform UI |
  71. | `src/Educ8.App.Gtk` | Linux app (GTK 4 + libadwaita) |
  72. | `packaging/`, `.github/workflows/` | Linux packaging (tar.gz, Flatpak, snap) and CI/releases |
  73. | `docs/` | Design notes, API findings and decisions; start at [docs/README.md](docs/README.md) |

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.