Skip to main content
Glama

UNOFFICIAL CMU Schedule of Classes — MCP Server & Claude Plugin

An MCP (Model Context Protocol) server that lets Claude, or any MCP-capable agent, query Carnegie Mellon's public Schedule of Classes. No login or API key is required. It reads the same pages the SOC website serves, plus the registrar's final-exam schedule and the current undergraduate catalog.

The repo is also a Claude Code plugin (cmu-soc). It bundles the server with a schedule-planning skill: a guided workflow that confirms the semester, collects the student's goals and remaining requirements, verifies prerequisites, checks minis, recitations and final exams, and renders a mock schedule from a fixed template.

A CMU counterpart of ucla-soc-mcp.

Tools

Tool

What it does

list_semesters

Semesters published in the SOC (S27 = Spring 2027, F26 = Fall 2026, M26 = Summer 2026), newest first

list_departments

Every department's code (CS, MSC, ECE, …) and the course-number prefix it owns (CS = 15)

search_courses

Every course a department offers in a semester: number, title, units. Optional campus filter

get_course_details

Sections of one course: lectures with nested recitations/labs, mini (1–6), and each meeting's days, times, campus and delivery mode. Extra meetings (e.g. evening exam slots) are included

get_course_info

The SOC course page: prerequisite/corequisite expressions (15112 or 02120) and the courses they name, cross-listings, special permission, notes, per-section reservations, description, related URLs

get_final_exams

Registrar final exams for several courses at once: date, time, exam room, status, instructors. A recitation input returns its lecture's exam. Says published: false for semesters the registrar hasn't posted

get_course_description

Current Undergraduate Catalog entry: semesters offered, units, description, prerequisites with minimum grades, corequisites, course website

estimate_walk_time

Offline walking-time estimate between two buildings, from room strings like GHC 4401 or names like Wean Hall

list_buildings

The 37 buildings estimate_walk_time knows, with SOC building codes and approximate coordinates

Inputs are forgiving:

  • Semesters accept S27 or Spring 2027.

  • Course numbers accept 15-122, 15122, or cs 15-122.

  • Departments accept CS, Computer Science, or 15.

Unknown inputs return errors that list the valid options.

What CMU does not publish

CMU's public schedule has no seat counts, waitlists, rooms or instructors. Students see those in SIO, which needs a login. The tools never invent them: each section-level result carries a not_public note. Unlike the UCLA server, there is therefore no open-seat filter, and walking estimates need rooms the student supplies. Instructors appear only in the final-exam schedule, as names; Andrew IDs are removed.

Final exams cover the current semester only. The registrar posts them around week 6 (early October in fall, late February in spring), so for the semester being planned they usually aren't out yet. get_final_exams says that explicitly rather than reporting "no conflict".

Degree audits

CMU audits live in Stellic, which needs a login and has no documented export format. A Stellic parser (the equivalent of the UCLA plugin's DARS script) is not included yet. For now, the skill asks the student to paste their unmet requirements.

Related MCP server: comsats-timetable-mcp

Setup

The repo is its own plugin marketplace. In Claude Code:

/plugin marketplace add aaditsingh07/cmu-soc-mcp
/plugin install cmu-soc@cmu-soc-mcp

No build step is needed: the plugin ships a self-contained server bundle (dist/bundle.cjs) that runs on Node 18 or newer. Start planning with /cmu-soc:schedule-planning, or just ask about CMU classes and Claude will pick the skill up on its own.

  1. Download cmu-soc.mcpb from the latest release.

  2. Double-click it, or drag it into Claude Desktop's Settings → Extensions, and click Install. Claude Desktop runs it with its own built-in Node.js, so there's nothing else to install.

  3. (Optional, for the guided planner.) Download cmu-schedule-planning.zip from the same release and upload it in Claude Desktop's Skills settings (Settings → Capabilities → Skills).

  4. Ask something like "Plan my Spring 2027 schedule at CMU".

To rebuild both files from source, run npm install && npm run pack:desktop. They are written to dist/.

Claude Desktop (manual config)

If you'd rather not use the extension, add this to claude_desktop_config.json (Settings → Developer → Edit Config), using the absolute path to dist/bundle.cjs in your clone:

{
  "mcpServers": {
    "cmu-soc": {
      "command": "node",
      "args": ["/absolute/path/to/cmu-soc-mcp/dist/bundle.cjs"]
    }
  }
}

Claude Desktop doesn't inherit your shell's PATH. If node isn't found, use its absolute path for command (find it with which node). Restart Claude Desktop fully afterwards.

Manual build / any other MCP host

git clone https://github.com/aaditsingh07/cmu-soc-mcp.git
cd cmu-soc-mcp
npm install
npm run build

The server uses stdio: run node dist/bundle.cjs (or node dist/index.js after a build). All tools are read-only.

Testing

npm run test:unit   # parsers against hand-written fixtures (offline)
npm test            # build + unit tests + live smoke test against CMU's sites

Access policy

Checked on 2026-11-18.

Host

robots.txt

How this server uses it

enr-apps.as.cmu.edu (SOC)

none (404), so no restrictions

Course search and course detail pages. The site describes itself as being for "the general public"

coursecatalog.web.cmu.edu

disallows /course-search/, /search/, /ribbit/, /pdf/, /previous/, …

Department course pages only, current catalog only. Disallowed paths are never requested

www.cmu.edu

disallows /cmufront/, /myandrew

The registrar's final-exam PDFs under /hub/docs/

CMU's website terms allow "personal viewing and non-commercial use" and prohibit redistributing site content. This project is built for that:

  • each user runs it locally;

  • it fetches public pages only when asked;

  • it keeps responses in memory only (semesters 1 h, department searches 1 h, course pages 6 h, final-exam PDFs 6 h, catalog pages 24 h);

  • it sends a generic cmu-soc-mcp/1.0 User-Agent;

  • it never has more than two requests in flight per host.

The repo contains no CMU pages, PDFs or catalog text; test fixtures are hand-written. Don't host it as a public service or use it commercially.

How it works

  • Semesters and departments: the SEMESTER and DEPT selects on GET /open/SOC/SOCServlet/search. Department labels carry their course prefix ("Computer Science (15XXX)").

  • Courses and sections: POST /open/SOC/SOCServlet/search with one department returns one table of every course. Continuation rows omit their opening <tr>. A blank section cell is an extra meeting of the section above. Lettered sections after Lec N belong to that lecture. A mini's number is its section's last digit.

  • Course detail: GET /open/SOC/SOCServlet/courseDetails?COURSE=15122&SEMESTER=F26. Columns are read by header, because summer adds a "Session" column. The server checks the department search first, because requesting a course that isn't offered returns HTTP 500.

  • Final exams: https://www.cmu.edu/hub/docs/final-exams.pdf and final-exam-mini.pdf. Their text layer is read with unpdf (pdf.js). The URLs are reused each semester, so each PDF's title line decides which semester it covers.

  • Catalog: CourseLeaf department pages (<dl class="courseblock">). src/catalog-pages.ts maps course prefixes to pages; regenerate it each catalog year with node scripts/build-catalog-pages.mjs.

  • Buildings: codes come from the SOC building legend. Walking time is the haversine distance × 1.4, at 80 m/min.

Notes

  • Not affiliated with Carnegie Mellon University. Data comes from public CMU pages and may change. The SOC is refreshed nightly, and departments may alter schedules at any time.

  • get_course_details returns at most 4 listings for a course number (topics courses can repeat a number).

  • get_final_exams takes up to 12 courses per call.

License

Code: Unlicense — public domain.

Building coordinates in src/buildings.ts are derived from OpenStreetMap data, © OpenStreetMap contributors, available under the ODbL. One point (Gesling Stadium) comes from Wikidata (CC0).

Available Tools

9 tools
estimate_walk_timeEstimate walking time between buildingsA
Read-only

Offline estimate of the walk between two CMU Pittsburgh buildings. Accepts room strings ("GHC 4401", "DH A302", "Wean Hall 7500") or bare building names/codes. Rooms are not in the public schedule, so they come from the student (SIO). Straight-line distance between building centroids x 1.4 for real paths, at 80 m/min: for spotting tight passing periods, not navigation.

Inputs: to_location (required), from_location (required).

get_course_descriptionGet catalog course descriptionA
Read-only

The current CMU Undergraduate Catalog entry for a course: title, semesters usually offered, units, description, prerequisites (with minimum grades, e.g. '15-112 Min. grade C'), corequisites and course website. Term-independent. Only the current catalog year is available, and graduate courses are often absent; get_course_info covers any offered course.

Inputs: course_number (required).

get_course_detailsGet course sections and meeting timesA
Read-only

Every section of one course in a semester: lectures with their nested recitations/labs, mini (1-6; minis 1/3/5 are the first half of the semester, 2/4/6 the second), and each meeting's days, begin/end time, campus and delivery mode. Extra meetings (e.g. an evening exam slot) appear as additional meetings of the same section. Seats, waitlists, rooms and instructors are not published publicly.

Inputs: semester (required), course_number (required), campus.

get_course_infoGet course prerequisites, notes and reservationsA
Read-only

The Schedule of Classes detail page for one course in a semester: description, prerequisite and corequisite expressions as the SOC states them (e.g. '15112 or 02120') plus the course numbers they mention, cross-listed courses, whether special permission is required, notes, per-section reservations (seats held for certain students), and related URLs.

Inputs: semester (required), course_number (required).

get_final_examsGet final exam timesA
Read-only

Final exams from the University Registrar's published schedule for several courses at once (e.g. ["15-122", "21-127 A", "15-213 Lec 1"]): date, day, time, exam room, delivery mode, status and instructors. A recitation input also returns its lecture's exam. The registrar only publishes the current semester, around week 6; for any other semester the result says published:false. A course with no row is 'none listed', not proof of no final.

Inputs: courses (required), semester (required).

list_buildingsList known CMU buildingsA
Read-only

Every CMU building estimate_walk_time knows, with the Schedule of Classes building code, alternate names and approximate coordinates (© OpenStreetMap contributors, ODbL).

Inputs: search.

list_departmentsList CMU departmentsA
Read-only

Every department in the Schedule of Classes with its code (CS, MSC, ECE, ...) and the two-digit course-number prefix it owns (CS = 15, MSC = 21).

Inputs: no named parameters.

list_semestersList CMU semestersA
Read-only

Semesters currently published in the CMU Schedule of Classes, newest first, with codes (S = Spring, F = Fall, M = Summer; e.g. S27 = Spring 2027).

Inputs: no named parameters.

search_coursesSearch a department's coursesA
Read-only

Every course a department offers in a semester: course number, title and units. Seat availability is not public at CMU, so there is no open/waitlist filter. For sections and times of one course use get_course_details.

Inputs: semester (required), department (required), campus.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 9 tools

    Disambiguation4/5

    Most tools have crisp, distinct scopes (semesters, departments, buildings, exams, walk time), and descriptions explicitly redirect between related tools (search_courses → get_course_details). The one soft spot is the trio get_course_details / get_course_info / get_course_description, where 'info' vs 'description' vs 'details' cover overlapping metadata (description, prereqs, coreqs) and rely on subtle distinctions like catalog-year vs offered-course coverage to be told apart.

    Naming Consistency5/5

    Every name follows a clean verb_noun snake_case pattern: list_buildings, list_semesters, list_departments, search_courses, get_course_details, get_final_exams, estimate_walk_time. Verbs are used consistently by intent (list = reference data, get = single-entity detail, search = query), with no camelCase or style drift.

    Tool Count5/5

    Nine tools sit comfortably in the well-scoped 3-15 range, and each maps to a concrete step in the workflow: resolve semester/department → search courses → drill into sections/info/catalog → check finals. The walk-time pair (estimate_walk_time + list_buildings) is a justified adjunct that its companion tool supports directly.

    Completeness4/5

    The surface covers the full course-research lifecycle: semesters, departments, course search, section times, catalog prereqs, and final exams, with explicit notes that seats and rooms are not public and therefore not gaps. The main missing operation is a cross-department or title-based course search — search_courses is department-scoped — plus no lookup for cross-listed course equivalence beyond what get_course_info returns.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    • Automate 1,000+ services from any MCP-compatible AI agent: build Applets, run actions and queries.

      https://ifttt.com/mcp
    • Acuity Scheduling MCP server for ChatGPT, Claude and any AI agent: list appointments, check availability, book appointment, reschedule appointment, cancel appointment and block off time in your own Acuity Scheduling account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Acuity Scheduling yourself; Cotlet does not store your password and you need no Acuity Scheduling API key. About the official Acuity Scheduling API: Acuity Scheduling has a full REST API but no official MCP server (checked 17 Oct 2026). The API uses HTTP Basic auth with your user ID and API key, and Acuity says API access is available on the Premium plan (formerly Powerhouse), so Starter and Standard accounts have no key to give an agent. Setup and FAQ: https://cotlet.dev/integrations/acuity-scheduling-api-mcp-server

    • Skedda MCP server for ChatGPT, Claude and any AI agent: list bookings, create booking, cancel booking, approve booking request and block out a space in your own Skedda account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Skedda yourself; Cotlet does not store your password and you need no Skedda API key. About the official Skedda API: Skedda has a read-only API in beta and no official MCP server (checked 31 Oct 2026). It lists spaces and booking occurrences and sends webhooks for booking events, on Skedda Premier and AllBooked Advanced. Setup and FAQ: https://cotlet.dev/integrations/skedda-api-mcp-server

      https://cotlet.dev/mcp/v1/skedda
    • Search and inspect source-pinned agent skills, plugins and tools through a free public MCP.

      https://skills.maqamagent.com/mcp

    Related MCP Servers