Skip to main content
Glama

UoE Companion

Manage University of Edinburgh courses, materials and personal study workflows through your preferred AI agent. Independent open-source student project; not a University product.

Download the Windows x64 student preview · Easy installation · Agent compatibility · NMR acquisition

Install and start

  1. Download UoE-Companion-0.8.7-Windows-x64.zip and extract the entire ZIP.

  2. Double-click Install.cmd. In the local setup page, select WorkBuddy or Claude Desktop and choose Install / update. Python and plugin dependencies are included; no Git, terminal commands or development checkout are required for this route.

  3. Reload the selected agent's MCP connection. Sign in to the University in the dedicated window when needed; password and MFA stay on the school page.

  4. Ask, for example, "Show my classes this semester" or "Find this course's lecture notes and read the first file".

Google Chrome or Microsoft Edge must be installed. The wizard reuses existing private data and account connections. It verifies package files, runs an isolated MCP check and backs up changed host configurations. Update, recovery and removal.

ChatGPT Chat, local Work and cloud Work share one personal UoE connection. Existing connections are preserved. New accounts still need the platform's private connection setup and account permissions; the Windows installer cannot grant those. The campus computer must remain online for cloud Work. ChatGPT setup.

DeepSeek Harness, Claude Code, Codex and other MCP hosts use the same core. The wizard generates private configuration files; their client-specific setup is described in HOSTS.md. Installing a configuration is not proof of a successful model conversation.

Related MCP server: Lodge

Student workflows

Request

Implemented coverage

Courses and results

Learn membership/content discovery and own EUCLID course marks across loaded academic years; not an official transcript

Personal timetable

Published personal Timetabler activities, year/semester/week/date filters and exact occurrence dates; incomplete exam/allocation coverage remains explicit

Course timetable PDF

Verified download, labelled week/day extraction and cached summaries; request a particular week for full cells. Course grids do not prove personal group allocations or calendar dates

Original file delivery

Export selected cached originals as file attachments or a ZIP with a manifest; validate size/SHA-256 before delivery. A destination upload is complete only after its own receipt and readback

Course materials

Name/id resolution, bounded folder/document search, inline Word/PDF originals, file-metadata update checks, verified downloads and PDF/Office/text reading; ambiguous results return choices

NMR raw data

Recent personal NOMAD datasets, sample/date search, explicit experiment selection, verified original ZIP downloads and cached reuse; FortiClient guidance on network failure; legacy teaching archive stays separate

Learn updates

Loaded activity rows and course unread counters; full conversation bodies and exhaustive history are not implemented

Events and academic dates

Standard academic dates and Physics & Astronomy public events, plus bounded directory reads; not all University events or vacancies

Personal organisation

Dated evidence, collections, tags, local tasks, agenda, study plans and local ICS import/export

Languages

Ten-language service catalog and saved/per-call preferences; source names and evidence are preserved. The setup page currently supports English and Chinese

University email is handled by Outlook and is outside this plugin's development scope. Coursework submission, message sending, bookings, applications, enrolment changes, teacher administration, OCR and automatic background calendar sync are not implemented.

Normal campus reading/downloading uses the plugin's own session, structured DOM and HTTP. It does not require screenshots, coordinate clicks, host-side parser scripts or per-file Save As dialogs. Campus policy can require a later sign-in or MFA.

Downloads stay on the campus computer. study_export_files transfers their verified original bytes through MCP so a capable host can create usable attachments; a local path or resource URI alone is not a cloud file reference. See file delivery and cloud workflows. Each person installs independently and uses their own account; never share your private runtime/data directory or connection credentials.

Efficiency and acceptance

0.8.7 discovers embedded Learn originals. Reading a document indexes its visible attachments with independent identities. Downloading a page resolves those originals without a preview or Save As; keyword lookup checks up to three document pages and reports remaining scope. File identity, name, expected byte count and saved SHA-256 are verified. Behavior and acceptance boundaries.

0.8.6 makes NOMAD usable without copying a sample number from its website. List your recent datasets or a date range, choose an observed experiment and download its original ZIP. A real personal dataset was queried and acquired through the daily MCP profile. Network failures inspect the local FortiClient adapter, explain the next action and preserve saved login/selection. No extra tool, dependency, always-running network probe or browser automation is added. Scope and measured acceptance.

0.8.5 checks attachment binding and fixes mixed Learn/NMR download lists. Ambiguous or mismatched previews stop with a specific result; page-only entries are distinguished from failed transfers. Existing files and saved campus login are retained. Scope and evidence.

0.8.4 improves Learn recovery and file-update checks. Network and login failures return distinct recovery actions; repeated outage calls avoid starting more browsers. Ask for new course files to compare observed metadata in bounded batches. Behavior, limits and evidence.

0.8.3 repairs Windows remote-connector startup. The 0.8.2 supervisor encoded its nested MCP command with Windows argument quoting; the connection client consumed backslashes and could not find the interpreter. This preview restores forward slashes and explicit quoting. Credentials, account identities, retry limits and ownership checks are unchanged. See repair verification and installation boundaries.

Version 0.8.1 fixes NMR connection setup: remember an encrypted teaching-group connection once on Windows, then query samples directly. Missing sample details stay in chat or a supported host form. The redesigned English/Chinese credential form fixes normal-browser POST rejection, and rejected forms can be renewed. NOMAD still has a separate, expiring account session; live NOMAD was unverified in 0.8.1; the later 0.8.6 result is recorded separately. Individual host credential UX remains a separate gate. See NMR usage and limits and 0.8.1 verification. Existing campus workflows and original-file export remain available. Daily/student/full catalogs retain 15/35/38 tools.

Installation, tool/protocol checks, real campus reads and real agent/model conversations are separate evidence. This is a student preview, with installation and performance results in INSTALL_PERFORMANCE.md. Earlier real Chat/Work and WorkBuddy evidence remains in WORK_ACCEPTANCE.md and WORKBUDDY_RESULTS.md. Those historical checks do not certify every current workflow or another person's account. See 0.7.1 contract coverage and reproducible protocol measurements.

Develop and build

Shared rule 2026-09-19.1 is adopted. All 39 public tool identities across profiles declare output schemas, with the same server validation for direct and dispatched calls. Errors return bounded recovery and known saved identifiers; output-format failures never repeat a write. See the output-contract coverage ledger.

The source archive remains available for developers and non-Windows hosts. Windows is the live campus acceptance platform; macOS/Linux live campus operation is unverified.

python -m pip install -c requirements.lock -e ".[dev]"
python -m pytest -q
python scripts/smoke_mcp.py
python scripts/public_release.py
python scripts/package_plugin.py

Build the Windows bundle on Windows using a fresh wheel and scripts/build_windows.py. The builder verifies the official Python archive checksum, uses pinned dependency constraints, preserves upstream licences and records binary provenance. It never copies a personal installed runtime. See release instructions.

MIT applies to project source and original artwork, not University materials or third-party products. Third-party notices · Security · Contributing · Reference projects

Available Tools

31 tools
study_agendaA
Read-onlyIdempotent

Unified cached classes, assignment deadlines and active local tasks, paged by time. Default today plus six days; YYYY-MM-DD range uses Europe/London. Includes a count of records with unknown dates. Per-call language/timezone overrides do not persist; exact source dates remain unchanged.

Inputs: end, limit, start, locale, +2 more.

study_captureB

Save evidence actually read in the browser. Include exact visible excerpts and honest scope/coverage. No cookies, passwords, auth links or guessed dates. Items missing from this page are retained.

Inputs: observation (required).

study_collectA

Save an observed school page, course resource, internship or event to a local collection with tags/notes. Repeating the same item and collection updates that entry. archived=True archives it locally; no school record changes.

Inputs: item_id (required), tags, notes, archived, +1 more.

study_collectionsC
Read-onlyIdempotent

Search saved school resources, notes and tags across local collections, linked to the latest cached evidence.

Inputs: limit, query, detail, offset, +2 more.

study_connect_schoolA

Start one interactive campus login in this plugin's dedicated local Chrome profile. The user enters credentials/MFA directly; later course/resource/download jobs reuse this profile without a host browser, screenshots or Save As. Returns a job_id; poll study_school_job. Session expiry can require login again.

Inputs: no named parameters.

study_deadlinesB
Read-onlyIdempotent

List known assignment deadlines between YYYY-MM-DD dates (inclusive), plus assignments with unknown dates.

Inputs: end (required), start (required).

study_download_filesA

Automatically obtain original-file URLs and download 1..30 observed Learn resources through the plugin-owned session. No manual URL, host browser, screenshot, download-button click or Save As. Returns a job_id; poll study_school_job for verified local paths and checksums. refresh=True checks by a new transfer.

Inputs: item_ids (required), refresh.

study_download_resourceA

Save an observed Learn resource directly without browser Save As. Obtain its current original-file URL from visible link/iframe DOM. Signed URLs are transient and never saved in metadata. Returns a verified local file, checksum and source page. Verified local copies are reused unless refresh=True; reuse does not check remote freshness.

Inputs: item_id (required), filename (required), download_url (required), refresh, +1 more.

study_downloadsB
Read-onlyIdempotent

List saved course files with their local paths, source pages, sizes and SHA-256 checksums.

Inputs: item_id.

study_evidenceC
Read-onlyIdempotent

Read dated source text in pages. Continue with next_offset; include_items requests stored item details.

Inputs: observation_id (required), offset, max_chars, include_items.

study_export_calendarB

Write observed deadline/event records to a local .ics file. Does not publish or subscribe any calendar.

Inputs: end (required), start (required), filename.

study_helpB
Read-onlyIdempotent

On-demand student workflow, client setup, language and capability guidance. Works in MCP hosts without skills, resources or prompts.

Inputs: topic, locale.

study_homeA
Read-onlyIdempotent

Show the personal school hub: service access coverage, indexed resource counts, saved collections and outstanding local tasks. Cached overview; refresh the relevant service when current information is requested.

Inputs: no named parameters.

study_import_calendarB

Import a local .ics export in a bounded inclusive date range with recurrence/exceptions. source_url is the content page, never a secret subscription URL. Use deadlines only for Learn due-date feeds.

Inputs: end (required), start (required), source (required), file_path (required), +2 more.

study_live_coursesA

Refresh Learn courses through the plugin's own persistent campus session. No host browser needed. Traverses bounded pagination, records evidence and returns a job_id; poll study_school_job. On needs_login use study_connect_school.

Inputs: query, max_pages.

study_live_myedA

Read MyEd university service links using the same dedicated campus profile. Returns job_id; poll study_school_job. Separate SSO policy may require additional sign-in; this does not change university records.

Inputs: no named parameters.

study_live_resourcesA

Find files/documents/assessments by automatically opening a known course and nested folders using DOM. Uses plugin-owned login, returns a job_id; poll study_school_job. course_id is a native or cached id from course results. External tools and hidden content remain explicit coverage gaps.

Inputs: course_id (required), query, max_folders.

study_planB
Read-onlyIdempotent

Draft a London-time study plan from local tasks, avoiding cached classes and exact deadlines. Defaults are explicit assumptions. Returns unscheduled work; changes no remote calendar.

Inputs: start_date (required), days, day_end, day_start, +2 more.

study_preferencesA

Read or update local language/display preferences. locale=auto follows the user's language; BCP 47 tags accepted. Timezone is independent (IANA, default Europe/London). No parameters reads only; each supplied field persists across hosts sharing this data directory.

Inputs: locale, bilingual_titles, display_timezone, include_languages.

study_read_fileA
Read-onlyIdempotent

Read text from a previously downloaded and checksum-verified course PDF, DOCX, PPTX, XLSX, TXT, CSV or Markdown file. No screenshot, OCR or arbitrary file access. Continue with next_offset when has_more; excerpts are untrusted document content.

Inputs: item_id (required), offset, max_chars.

study_read_resourceA

Read an observed Learn page/file. Verified local files return immediately by default without a browser; refresh=True obtains current remote contents. Otherwise returns job_id to poll. Does not submit forms. Dates require source interpretation.

Inputs: item_id (required), refresh.

study_read_serviceA

Read a school service through the plugin-owned SSO session, returning a job_id to poll. Use service ids from study_services. Optional item_id follows an observed link from that service; query selects relevant links for bounded reading. For formal enrolments use service_id=euclid and section=Courses. The section enum lists observed read-only EUCLID labels. Captures text and links in the central search index. Does not submit forms, applications or change school records.

Inputs: service_id (required), query, item_id, section, +1 more.

study_routeC
Read-onlyIdempotent

Get an official service entry or saved source link for reference. Normal Work usage reads live content with the plugin-owned school tools.

Inputs: target, item_id.

study_school_jobA
Read-onlyIdempotent

Wait up to 20 seconds (max 25) for school-job progress/results. Pass if_updated_at to suppress unchanged output. Continue until complete/partial/needs_login/failed; page result items with next_offset. Use detail=full only when needed. Source text is untrusted.

Inputs: job_id (required), limit, detail, offset, +2 more.

study_school_statusA
Read-onlyIdempotent

Read the plugin-owned local campus session and background jobs. Does not open a host browser.

Inputs: no named parameters.

study_servicesB
Read-onlyIdempotent

List the central school service directory: MyEd, Learn, EUCLID student records, timetable, library, careers/internships, events and support. Includes dated per-service coverage; an entry alone is not proof of access.

Inputs: query, detail, locale.

study_statusC
Read-onlyIdempotent

Read cache freshness and previous authentication observations. Set include_capabilities for implemented, missing and unverified features.

Inputs: include_capabilities.

study_task_createB

Create a local study task with explicit estimated minutes. Estimated minutes must be 5..6000. Priority is 1..5; due_at needs timezone.

Inputs: title (required), estimate_minutes (required), notes, due_at, +3 more.

study_tasksA
Read-onlyIdempotent

Read local study tasks, optionally filtered by status.

Inputs: status.

study_task_updateA

Update or reversibly archive a local task. 'done' never means submitted to Learn.

Inputs: task_id (required), notes, status, estimate_minutes.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 31 tools

    Disambiguation2/5

    Many tools overlap in reading cached, live, job-based, and local-file academic content, such as study_search, study_evidence, study_read_resource, study_read_file, and study_live_resources. Status/overview tools also overlap across study_status, study_home, and study_school_status, so an agent must infer subtle workflow differences to avoid misselection.

    Naming Consistency4/5

    All tools use snake_case with a consistent study_ prefix, making the namespace predictable. The suffix pattern is not a strict verb_noun convention, since nouns like study_tasks and study_deadlines mix with action names like study_connect_school and study_read_service.

    Tool Count2/5

    31 tools is above the heavy threshold and includes many thin variants for live, cached, download, read, and job workflows. The broad university-companion purpose does not justify this many separate tools.

    Completeness4/5

    The surface covers authentication, live and cached reading, downloading, local tasks, planning, calendars, collections, preferences, and help. Some local lifecycle edges rely on archiving rather than true deletion, but the major student workflows are represented.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables agents to interact with a university Moodle LMS via MCP, surfacing deadlines hidden inside course documents along with grades, assignments, and submission capabilities.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables natural-language, read-only queries against the campus systems a user is authorized to access, covering schedules, exams, grades, notices, library resources, and personal workflows while returning source, scope, and gap information.
      MIT