CLI commands
Choose a command name for its arguments, options and an example. You can also append --help to any command. CLI commands require the cli package extra; MCP setup and tool management also require mcp. Direct commands use service defaults and environment variables, independently of MCP profiles and tool settings. Command pages identify where --json is available. JSON writes results to stdout; diagnostics go to stderr. Personal operations require authentication. Actions and downloads require local confirmation.
Some resource groups also run their list or show command when the subcommand is omitted (for example, ntu learn courses and ntu onestop appointments).
NTULearn attachment, file, and video commands also accept a quoted NTULearn document or lecture launch URL instead of the course and content IDs. File commands still require an attachment ID. A content URL can also be used with learn content --parent.
Common short options are -h for help, -j for JSON, -r for refresh, -l for limit, -p for page, -y for academic year, -s for semester, and -o for a download destination, wherever the corresponding long option is supported.
One Stop request applications, appointment bookings and cart checkout run as standalone interactive workflows. Their temporary state remains in the process. Attachments must be selected from the configured upload directory.
cli
| Command |
Purpose |
ntu cli setup |
Interactively choose whether to save credentials and install Chromium for personal services. |
mcp
auth
| Command |
What it does |
ntu auth save |
Prompt for an account and password and save them in the native OS keyring. |
ntu auth status |
Check whether credentials are stored without displaying them. |
ntu auth delete |
Confirm and remove the saved credentials from the keyring. |
config
stars
Examples and detailed stars commands
| Command |
What it does |
ntu stars course |
Get course name, AUs, prerequisites, description, and term metadata. |
ntu stars prerequisites |
Build before and after branches around a course, with separate depth limits. The before branch follows the course's prerequisite rules; the after branch finds courses that depend on it in the selected term. |
ntu stars index |
Get one index's complete schedule, vacancies, and waitlist where matching-term counts are published. |
ntu stars exams |
Get public General Access exam dates and times for a course in the latest or specified published term. |
ntu stars graduate |
Get a graduate course's class groups for NTU's currently published academic term. |
ntu stars audit |
Get your degree requirements, examination results, and registered courses from Degree Audit. |
ntu stars auth status |
Sign in to STARS and report whether access is verified. |
ntu stars courses search |
Search NTU's public undergraduate Class Schedule by partial code or title keywords. |
ntu stars indexes compare |
Compare shared and index-specific sessions; optionally check clashes with supplied time slots. |
ntu stars indexes match |
Find indexes matching day/time/lesson/week rules and avoiding supplied timetable clashes. |
ntu stars indexes list |
List a page of indexes with timetable details and matching-term vacancies/waitlists. |
ntu stars planner show |
Get registered courses, the published term, and saved Plans 1–3 with indexes and timetables. |
ntu stars planner save |
Replace saved Plan 1, 2, or 3 with the complete supplied course/index list for the current Planner term. |
ntu stars rooms schedule |
Get all published undergraduate course/index lessons using one observed room, including full-time and part-time offerings. |
ntu stars rooms available |
Find teaching-free rooms; this does not establish occupancy or bookability. |
learn
Examples and detailed learn commands
| Command |
What it does |
ntu learn attachments |
List files attached to a course content item. |
ntu learn announcements |
Read published announcements for one enrolled course. |
ntu learn grades |
Read visible gradebook columns and your own scores/status. |
ntu learn calendar |
Read calendar entries and published deadlines, across your courses or for one course. |
ntu learn upcoming |
Collect all calendar pages across your enrolled courses. |
ntu learn digest |
Digest of recent announcements, upcoming calendar items and your gradebook across courses. |
ntu learn users |
List course users visible to your account, with their published names and roles. |
ntu learn auth status |
Sign in to NTULearn and report whether access is verified. |
ntu learn content tree |
Read a course's nested content tree. |
ntu learn content show |
Read one level of course content. |
ntu learn courses download |
Recursively save readable Blackboard attachments under destination/course_id with content folder names and stable file IDs. |
ntu learn courses list |
List your enrolled NTULearn courses and organizations, including published availability and course IDs. |
ntu learn files read |
Read an attachment inline as text: PDF, DOCX, PPTX, XLSX and UTF text/code. |
ntu learn files download |
Download a Blackboard attachment to an explicit local file path, up to 20 MB. |
ntu learn groups members |
List visible members of a course group through Blackboard's browser membership API. |
ntu learn groups list |
List groups and group sets defined in a course. |
ntu learn messages list |
List Blackboard inbox/sent messages through readable course conversations, without marking them read. |
ntu learn messages read |
Read a message's full body and published conversation recipients. |
ntu learn search all |
Recursively search content across available enrolled courses, or selected course_ids. |
ntu learn search course |
Recursively search one course's content titles, body and description for a case-insensitive substring. |
ntu learn videos download |
Download a Kaltura video embedded in an NTULearn content item to a new local file. |
career
Examples and detailed career commands
map
Examples and detailed map commands
| Command |
What it does |
ntu map campuses |
List campuses in NTU's MazeMap collection with IDs and center coordinates. |
ntu map buildings |
List campus buildings and their floor IDs/names/levels. |
ntu map search |
Search NTU rooms, venues and amenities by code, name or category, including aliases such as TR+7. |
ntu map place |
Read one NTU place's location, aliases, building, floor, categories and published description/capacity. |
ntu map directions |
Get walking routes between two NTU POIs, estimated metres/seconds and English instructions where available. |
research
Examples and detailed research commands
| Command |
What it does |
ntu research search |
Search DR-NTU publications by keywords or Solr query. |
ntu research facets |
Discover search facet names, or supply a facet name to list its values and counts for the query/scope/filters. |
ntu research dataset |
Read a published DR-NTU Data dataset by doi: identifier: title, authors, descriptions, subjects, license and paginated file inventory. |
ntu research browse communities |
Browse repository communities or collections. |
ntu research browse collections |
Browse repository communities or collections. |
ntu research bundle files |
List a bundle's file metadata: names, byte sizes, checksums, published rights and content URLs. |
ntu research item bundles |
List an item's file groups. |
ntu research item show |
Read a repository item's published metadata, including abstracts, citations, DOI, subjects and rights where supplied. |
ntu research oai info |
Describe DR-NTU's OAI-PMH repository, modification-date precision, deletion policy and earliest datestamp. |
ntu research oai formats |
List OAI metadata prefixes, namespaces and schemas. |
ntu research oai sets |
List OAI collection/community sets. |
ntu research oai records |
Read one bounded OAI records page, defaulting to oai_dc. |
ntu research oai record |
Get one record by its OAI identifier, not a REST UUID. |
library
Examples and detailed library commands
| Command |
What it does |
ntu library search |
Search NTU OneSearch for books, articles, journals and other catalogue resources. |
ntu library record |
Read a OneSearch record's bibliographic metadata, descriptions, subjects, identifiers and published access links. |
ntu library availability |
Read published physical holdings with library, location, call number and status, plus institutional full-text service links and access notes. |
ntu library facilities schedule |
Read a day's LibFacilities room/seat time grid, room description and source status classes. |
ntu library facilities list |
List NTU Library facility categories, library/floor maps and closure notices. |
ntu library map availability |
Read seat/room booking statuses for a library map at date YYYY-MM-DD and time HH:MM in Singapore. |
faculty
Examples and detailed faculty commands
| Command |
What it does |
ntu faculty search |
Search NTU's public faculty directory by name, optionally filtered by one research interest. |
ntu faculty interests |
List current faculty research-interest labels and filter IDs from NTU's directory form. |
news
Examples and detailed news commands
| Command |
What it does |
ntu news search |
Search public NTU news by keyword and optional category, sorted latest or oldest. |
ntu news categories |
List current news category labels and filter IDs from NTU's official news form. |
ntu news article |
Read the published text of an NTU /news/detail/ article URL returned by news_search. |
services
Examples and detailed services commands
| Command |
What it does |
ntu services search |
Find NTU food outlets, shops, clinics and campus services by name/address keyword and optional location substring. |
ntu services filters |
List official campus service type and category labels with filter IDs. |
bus
Examples and detailed bus commands
| Command |
What it does |
ntu bus routes |
List public NTU shuttle routes and their published display colors. |
ntu bus stops |
Search NTU shuttle and LTA bus stops by stop name or code, optionally limited to a route/service. |
ntu bus arrivals |
Get arrival estimates for NTU shuttles and/or LTA services 179, 179A, and 199. |
ntu bus live |
Get current live vehicle positions for one NTU campus shuttle route. |
ntu bus status |
Get the published first/last bus schedule, public-holiday/special-day flags, and temporary notices for an NTU campus shuttle route. |
onestop
For examples, output fields and workflow guidance, use the One Stop CLI guide.
Catalog
Details and examples
Requests
Details and examples
Appointments
Details and examples
Knowledge
Details and examples
| Command |
What it does |
ntu onestop knowledge search |
Search the signed-in student's One Stop knowledge base. |
ntu onestop knowledge article |
Read a knowledge article's text, text-template sections or wiki body by article_id from search_knowledge, with text pagination and source links. |
ntu onestop knowledge feedback |
Read native knowledge capabilities: ratings, helpfulness, comments, flags/reasons, subscription/inheritance, favourites and self-delivery channels. |
ntu onestop knowledge rate |
Submit a 1–5 star knowledge rating when the native control is enabled. |
ntu onestop knowledge helpful |
Submit helpful/not-helpful feedback only when the article offers that native control. |
ntu onestop knowledge flag |
Flag a knowledge article with the user's explanation when the native flag control is available. |
ntu onestop knowledge subscribe |
Subscribe/unsubscribe to article updates. |
ntu onestop knowledge favourite |
Set an article's native favourite state when its Favourite control is enabled. |
ntu onestop knowledge send-to-self |
Send this article to your registered email/SMS channel using the native Send to myself action. |
ntu onestop knowledge comments add |
Publish plain-text feedback to a knowledge article, or reply to a visible parent comment. |
ntu onestop knowledge comments delete |
Delete a visible article comment only when the native menu permits deletion by the current user. |
ntu onestop knowledge comments like |
Like or unlike a visible knowledge comment using a desired state. |
ntu onestop knowledge comments list |
Read visible knowledge comments/replies, author display names, text, dates, reactions, attachment IDs and delete permissions. |
Attachments
Details and examples
Payments, cart and favourites
Details and examples
Dashboard and profile
Details and examples
Run ntu mcp to start the stdio server; ntu mcp --profile public and ntu mcp --profile personal select a profile. Run ntu --version to display the version. Run ntu --install-completion to install shell completion.