syllabus-calendar-mcp
Turns syllabus text into calendar events and valid .ics calendars locally, with no account or network needed.
extract_schedule_events: parses pasted syllabus text into dated events, assigns event types, uses a default or specified year, supportsterm_startfor week-based lines, and returns undated lines instead of dropping them.expand_recurring_classes: generates meeting dates for recurring classes by weekday and date range, skipping holidays and reading weeks and reporting skipped dates.build_ics: creates a valid .ics calendar from events and recurring classes, supports reminders, timezone, calendar name, and optional file output.merge_calendars: merges multiple calendars, deduplicates events by UID, and reports timed event conflicts.Runs entirely on your computer with no login, API key, or internet connection.
Generates valid .ics calendar files that can be imported into Apple Calendar, allowing syllabus events and recurring class schedules to be added to Apple's calendar app.
Generates valid .ics calendar files that can be imported into Google Calendar, allowing syllabus assignments, exams, labs, and recurring class schedules to be added to a Google calendar.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@syllabus-calendar-mcp turn this syllabus into calendar events: assignment 1 due sep 15, midterm oct 20 at 10:00"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
syllabus to calendar mcp
syllabus to calendar mcp is a free mcp server, published on npm as syllabus-calendar-mcp. turn pasted syllabus text into calendar events, build valid .ics files from events and recurring classes, skip holidays and reading weeks, and merge calendars to find conflicts. the math and parsing are done by tested code. it runs on your computer, needs no internet and no login.
parses pasted text from Canvas, Brightspace, Moodle or a PDF export.
free forever. no account.
comparison
brightspace-mcp-server and @exhabition/brightspace-mcp need a brightspace login before they can read anything. this server needs no account, no api key and no network. it works on syllabus text you paste, so it covers any school's syllabus, not only brightspace courses.
Related MCP server: lms-cli
sample output
paste text like this:
Assignment 1 due Sep 15
Midterm exam October 20 at 10:00
Lab report 2 due Dec 8extract_schedule_events with course set to BIO 101 and year set to 2026 returns:
3 events found.
- Tue, Sep 15, 2026: Assignment 1 (assignment) [BIO 101]
- Tue, Oct 20, 2026 at 10:00: Midterm exam (exam) [BIO 101]
- Tue, Dec 8, 2026: Lab report 2 (lab) [BIO 101]
Next: pass these events to build_ics as events to make an .ics calendar.if a pasted line has no date, it is not dropped. extract_schedule_events returns those lines in undated_lines and lists them below the events, so you can fix the text and run the tool again.
build_ics turns those events into a calendar that starts like this:
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//AnonymousOnyx22//syllabus-calendar-mcp//EN
CALSCALE:GREGORIAN
METHOD:PUBLISH
X-WR-CALNAME:BIO 101import into your calendar
the .ics file works in any calendar app. save the file, then import it.
google calendar
open google calendar in a browser. click the gear icon, then settings. open import and export, choose the .ics file, pick the calendar to add it to, then click import.
apple calendar
double click the .ics file. calendar opens and asks which calendar to add the events to. or open calendar, choose file, then import.
outlook
open outlook. choose file, then open and export, then import and export. pick import an ics or vcal file, select the .ics file and import it.
install
run it straight from npm with npx. you need node.js 20 or newer, see node version for the details.
npx -y syllabus-calendar-mcpadd it to your ai app's mcp config so the app can start it for you. every app reads its config from its own file, so pick yours:
claude desktop
add this to claude_desktop_config.json:
{
"mcpservers": {
"syllabus-calendar": {
"command": "npx",
"args": ["-y", "syllabus-calendar-mcp"]
}
}
}restart claude desktop after you save the file.
command line
run this in a terminal:
npx -y @modelcontextprotocol/inspector syllabus-calendar-mcpcursor
cursor reads mcp.json from the project folder at .cursor/mcp.json, or from your home folder at ~/.cursor/mcp.json.
{
"mcpservers": {
"syllabus-calendar": {
"type": "stdio",
"command": "npx",
"args": ["-y", "syllabus-calendar-mcp"]
}
}
}restart cursor after you save the file.
vs code copilot
put this in .vscode/mcp.json in your project folder, or in the mcp.json file in your user profile:
{
"servers": {
"syllabus-calendar": {
"type": "stdio",
"command": "npx",
"args": ["-y", "syllabus-calendar-mcp"]
}
}
}vs code also reads a portable .mcp.json file in the project root. that file uses the name mcpservers instead of servers:
{
"mcpservers": {
"syllabus-calendar": {
"command": "npx",
"args": ["-y", "syllabus-calendar-mcp"]
}
}
}restart vs code after you save the file.
try these four prompts
turn syllabus text into events
"turn this syllabus into calendar events: assignment 1 due sep 15, midterm exam october 20 at 10:00."
the model calls
extract_schedule_eventsand returns dated events with types and times.add a recurring class
"my biology class meets tuesday and thursday from sep 8 to dec 10, 2026 at 10:00. skip the reading week of oct 12 to oct 16."
the model calls
expand_recurring_classesand returns meetings plus skipped dates.make an ics calendar
"make an .ics file for my course with a reminder one day before each assignment."
the model calls
build_icswith events and reminders to produce a valid calendar.check for conflicts
"merge my three course calendars and tell me which classes conflict."
the model calls
merge_calendars, which merges the calendars, drops duplicate events by uid and lists timed events that overlap.
tools
four tools. these names are the ones your ai app sees.
tool | parameters | what it does | example prompt |
|
| extract dated events from pasted syllabus text, one per line with dates. set | "turn this syllabus into calendar events: assignment 1 due sep 15, midterm exam october 20 at 10:00." |
|
| generate meeting dates for a recurring class, skipping holidays and reading weeks. ends with a next step hint to | "my biology class meets tuesday and thursday from sep 8 to dec 10, 2026 at 10:00. skip the reading week of oct 12 to oct 16." |
|
| build a valid .ics calendar from events and classes, with reminders. pass | "make an .ics file for my course with a reminder one day before each assignment." |
|
| merge calendars, dedupe by uid and list timed conflicts. write to a file when output_path is passed. | "merge my three course calendars and tell me which classes conflict." |
every tool returns text and structured data. build_ics and merge_calendars may write files; other tools are read only.
troubleshooting
zero events came back. extract_schedule_events makes one event from each line that names a date. check undated_lines in the result: those are the lines it skipped. paste the schedule with one item per line, and write dates like "sep 15" or "9/15" on the same line as the title. if the text is one long paragraph, split it into lines first and try again.
the dates have the wrong year. when a date has no year, the tool uses the current year. the result shows the year it used. pass year (for example 2026) to extract_schedule_events, or write the year in the date. for expand_recurring_classes, give start_date and end_date with the full year.
the file was not written. build_ics and merge_calendars only write a file when you pass output_path. the folder has to exist already, because the server does not create folders. if the folder is missing, the answer names the folder it needs. use a full path you can write to, such as a folder in your home directory. a relative path is resolved from the folder the server was started in, which may not be where you expect. if you leave output_path out, you get the calendar text back and can save it as a .ics file yourself.
the server does not show up in your app. check that your node.js is version 20 or newer, then restart the app after you edit its config. the install steps above show the exact entry for each app.
node version
there are two floors here, and they are not the same number.
what you are doing | node.js |
running the published server | 20 or newer |
building and testing a clone | 22.12 or newer, on the 22 and 24 release lines or 26 and later |
the server itself is happy on node.js 20, and that is what engines in package.json says. the test tool wants a newer node.js, so the development floor lives in devengines in the same file. npm checks devengines before install and before tests. serviceh numbers live in package.json.
development
npm install
npm run build
npm testthe tests call tools through a real mcp client. no account or network needed.
privacy
all processing is local. no data is stored. no network calls. no login or keys required.
More free student MCP servers
All free, open source and read only where they touch your accounts. Browse the full list at brightspacemcp.com/more-mcps.
Server | What it does |
D2L Brightspace for AI. Due dates with real submission status, grades, a target grade calculator and course files. | |
Canvas LMS for AI, read only. Due dates, missing work, grades and announcements. | |
Moodle for AI, read only. Due dates, overdue work, grades and announcements. | |
Google Classroom for AI, read only. Todos, due dates, missing work and grades. | |
GPA, grade conversion and the grade you need on the final, for AI. Works offline, no account. | |
APA, MLA and Chicago citations from a DOI, an ISBN or typed details. No account. | |
Exam study schedules, spaced repetition dates, pomodoro plans and assignment milestones. Works offline. | |
Search scholarly papers, find open access copies and related work through OpenAlex. No key needed. | |
Clean, convert, dedupe and lint BibTeX, RIS and CSL JSON reference lists, and make cite keys. Works offline. | |
Find free legal copies of textbooks on OpenStax, DOAB and Open Library, look up editions by ISBN and suggest cheaper older ones. | |
Chemistry and physics homework math: molar mass, balancing equations, grams to moles, unit conversion and significant figures. Works offline. | |
Offline writing metrics for essays. Word and page counts, readability scores, passive voice, repeated openers, filler words, long sentences and word limit checks, so students can check their work against assignment requirements. No account, no network. | |
Job application tracker MCP server. Track internships, jobs, interviews and deadlines offline, see what is coming up, and export your list as CSV or Markdown. No account and no API keys. |
license
mit
Available Tools
4 toolsbuild_icsBuild an ics calendarA
Build a valid .ics calendar file from dated events and recurring classes, with reminders. Inputs: events (each with title, date, optional start_time, end_time, type, course, location and notes), classes (each with course, weekdays, start_date, end_date, start_time and optional end_time, location, holidays and reading_weeks), reminders_minutes (whole minutes before each event, default 60), calendar_name, optional timezone and optional output_path. Pass timezone as an IANA name such as America/Toronto so timed events keep the right hour in Google Calendar, Apple Calendar and Outlook. Each class becomes one weekly recurring event with holidays and reading weeks removed. The tool checks the file before returning it. Example prompt: "Make an .ics file for my course with a reminder one day before each assignment."
Inputs: events, classes, timezone, output_path, +2 more. Returns: ics, valid, errors, class_count, +3 more
expand_recurring_classesExpand recurring classesARead-only
Generate the meeting dates for a recurring class between two dates, and skip holidays and reading weeks. Inputs: course, weekdays (day names or codes such as Tuesday or TU), start_date, end_date, start_time, optional end_time, optional location, holidays (single dates or ranges) and reading_weeks (single dates or ranges). Returns every meeting date plus the dates that were skipped and why. The answer ends with a next step hint that points to build_ics when the class should become a calendar. Example prompt: "My biology class meets Tuesday and Thursday from Sep 8 to Dec 10, 2026 at 10:00. Skip the reading week of Oct 12 to Oct 16."
Inputs: course (required), end_date (required), weekdays (required), start_date (required), +6 more. Returns: title, course, skipped, end_date, +8 more
extract_schedule_eventsExtract schedule eventsARead-only
Extract dated events from pasted syllabus text. Each line that names a date becomes one event, with a title, a type, a date and optional times. Inputs: text (the pasted syllabus or course schedule, one event per line), course (a course name or code to put on every event), year (the year to use when a date has no year) and term_start (the first day of the term, so a line such as Week 5: Midterm becomes an event). Titles are read from the words around the date, and each event is marked as an assignment, exam, quiz, lab, reading, class or other. Any line that has no date is returned in undated_lines instead of being dropped silently. The answer ends with a next step hint that points to build_ics when the events should become a calendar. When no line names a date, the count is 0 and the next step tells the student how to fix the pasted text. Example prompt: "Turn this syllabus into calendar events: Assignment 1 due Sep 15, Midterm exam October 20 at 10:00."
Inputs: text (required), year, course, term_start. Returns: year, count, events, next_step, +1 more
merge_calendarsMerge course calendarsA
Merge several course calendars into one and list timed events that overlap. Inputs: calendars (each with an optional name and an ics string), optional calendar_name and optional output_path. Events with the same UID are kept once. Weekly and daily recurring events are expanded when conflicts are checked. Example prompt: "Merge my three course calendars and tell me which classes conflict."
Inputs: calendars (required), output_path, calendar_name. Returns: ics, valid, errors, conflicts, +3 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a distinct role in the pipeline: parse text, build an .ics file, merge calendars, and preview recurring class dates. The only soft overlap is that build_ics internally expands recurring classes (holidays/reading weeks) while expand_recurring_classes exists as a separate preview step, so an agent could hesitate on which to use for recurrence handling.
All four names are snake_case and verb-first (extract_, build_, merge_, expand_), matching a clear verb_noun convention throughout. build_ics uses an acronym noun but still fits the same pattern.
Four tools map cleanly onto the parse → build → merge/preview workflow with no filler. The count is tight but each tool covers a necessary stage of the syllabus-to-calendar domain.
The core lifecycle is covered: text extraction, .ics generation with reminders and timezones, calendar merging with conflict detection, and recurrence expansion. Minor gaps exist around editing/inspecting existing events or importing an .ics for non-merge purposes, but the stated purpose is well served.
Maintenance
Related MCP Connectors
Import a term from syllabi into Helium, a free student planner, and ask about what's due and grades.
Extracts calendar events from natural-language text, with .ics and calendar links.
Create and update subscription calendars from ChatGPT, Claude, or Codex.
Turn a written schedule into a live calendar link people subscribe to in Apple, Google, Outlook.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables course planning for University of Pennsylvania by searching the catalog, inspecting sections and ratings, detecting schedule conflicts, and building weekly schedules.15MIT
- AlicenseNot gradedqualityBmaintenanceEnables natural-language queries across multiple schools' Canvas and Blackboard accounts for courses, notifications, assignments, grades, feedback, and schedules, with read-only access and local todo/calendar export.9MIT
- AlicenseAqualityBmaintenanceGives AI assistants direct, on-demand access to McGill's public Visual Schedule Builder timetable data, letting them search course offerings, fetch sections and meeting times, check conflicts, and generate ranked schedule combinations without a login, API key, or browser session. Queries and schedule calculations run locally on structured results, with a short-lived cache for repeated requests.48 npm2MIT
- AlicenseBqualityBmaintenanceEnables users to query official undergraduate and graduate course schedules, indexes, prerequisites, and exam timetables, including tools for comparing indexes and finding matching schedules. It is read-only, local, and supports filtering by days, times, lesson types, teaching weeks, and schedule clashes.7211 PyPI1MIT