Helium - Student Planner
OfficialConnects AI assistants to a student's Helium account, allowing them to preview and import academic terms from syllabi and read planner data such as assignments, events, notes, classes, resources, and grades via Helium's API using the student's OAuth token.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
Helium is a free, color-coded online student planner for classes, homework, grades, and notes.
Helium Connector
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 installTo run the tests and the static checks, execute:
make test
make checkTo 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 runBasic 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 |
| Read | Every problem with a term's plan, or a summary to confirm, without saving anything |
| Write | The term's id and its classes' ids: a new term, or classes added to an existing one |
| Read | How many assignments or events an |
| Write | An |
| Read | Assignments due in a window or matching text, with class, category, completion, grade |
| Read | Events in a window or matching text, with repeating events listed per occurrence |
| Read | Notes as plain text, optionally matching text or for one class or linked item |
| Read | Classes by term, with meeting times, teacher, credits, grading, and grade scales |
| Read | Resources by resource group, with status, price, and the classes each is for |
| 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 |
| Sets up a term from your syllabi, asking about anything they leave unclear |
| 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-pluginUpload 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…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect AI assistants to Edusign attendance, courses, learners, documents, and API docs via OAuth.
Your AI professor for Helmley courses: reads your course and progress, teaches and sends plans.
Read-only access to a student's recorded classes: transcripts, notes, slides and concept map.
Connect an AI assistant to a Capacities space (objects, daily notes, search).
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables University of Toronto students to access academic data from ACORN and Quercus via AI assistants. It provides tools to retrieve course schedules, enrollment details, syllabi, assignments, and announcements.-
- AlicenseNot gradedqualityBmaintenanceEnables 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.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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
- AlicenseAqualityCmaintenanceEnables 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.10Apache 2.0