Skip to main content
Glama
Helium - Student Planner

Helium - Student Planner

Official

Helium is a free, color-coded online student planner for classes, homework, grades, and notes.


Helium Connector

Build Coverage Code Quality GitHub License

The Helium connector is a remote MCP server that connects AI assistants to a student's Helium account, to import a term from syllabi and read the planner. It makes no model calls, and calls Helium's API with the student's own OAuth token. The repository also holds heliumedu, a typed, async Python client for that API.

Prerequisites

  • Python (>= 3.13)

Related MCP server: Quirkus

Getting Started

To install the connector and its development dependencies into a virtual environment, execute:

make install

To run the tests and the static checks, execute:

make test
make check

To serve the connector locally at http://127.0.0.1:8001/mcp against a local platform, execute:

HELIUM_API_URL=http://localhost:8000 HELIUM_CONNECTOR_URL=http://127.0.0.1:8001 make run

Basic Usage

The connector is served at https://mcp.heliumedu.com/mcp. Add it to your AI assistant, then sign in to Helium and choose Allow when it opens in your browser. For a local connector, use http://127.0.0.1:8001/mcp instead. For a walkthrough, see Use AI as a Scheduling Assistant.

Ask your assistant to import a term from your syllabi, or about your planner, and it will use the following tools:

Tool

Access

Returns

preview_import_term

Read

Every problem with a term's plan, or a summary to confirm, without saving anything

import_term

Write

The term's id and its classes' ids: a new term, or classes added to an existing one

preview_import_ics

Read

How many assignments or events an .ics calendar file's entries would become

import_ics

Write

An .ics file's entries as a class's assignments, or as events, imported all at once

list_assignments

Read

Assignments due in a window or matching text, with class, category, completion, grade

list_events

Read

Events in a window or matching text, with repeating events listed per occurrence

list_notes

Read

Notes as plain text, optionally matching text or for one class or linked item

list_classes

Read

Classes by term, with meeting times, teacher, credits, grading, and grade scales

list_resources

Read

Resources by resource group, with status, price, and the classes each is for

get_grades

Read

Grades and trends per class and category, or the score needed for a grade or GPA

Each tool's JSON Schema, served by the connector, describes its inputs.

For assistants that offer prompts, these are listed alongside the tools:

Prompt

Does

import_syllabi

Sets up a term from your syllabi, asking about anything they leave unclear

plan_study_time

Suggests what to work on with the time you have, from your planner and grades

Permissions

Signing in grants the planner:read and planner:import scopes, plus planner:notes:read if the user checks it, shown on Helium's consent screen and described in its API documentation. list_notes works only with planner:notes:read. import_term and import_ics are the only writes, and they only add to Helium: no tool sends messages, makes payments, or changes or deletes anything.

Plugin Package

plugin/ is the connector as an Agent Plugins package: plugin.json, and mcp.json pointing at https://mcp.heliumedu.com/mcp. A plugin directory's listing, review cases, and release notes live under its key in plugin.json's extensions. Each release attaches it as helium-plugin-<version>.zip, with version set to the connector's; to build it locally, execute:

make package-plugin

Upload a new ZIP to the plugin directory only when plugin/ changes; tool changes reach listings from the server.

Documentation

Helium's API documentation is available at api.heliumedu.com/docs, and help with using Helium at the Support Portal.

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to read courses, upcoming deadlines, assignment details, grades, announcements, modules, files, inbox, and timetable from U of T Quercus and ACORN through read-only tools.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to inspect enrolled courses, extract readable text from course documents, track upcoming deadlines, view announcements, and retrieve assignment details through the platform’s REST API.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables an AI assistant to view a student's own course enrollments, deadlines, assignments, announcements, submission status, and released grades from their learning management system through read-only, policy-gated access.
      10
      Apache 2.0