Skip to content

One Stop: Dashboard and profile CLI commands

One Stop overview · All One Stop CLI topics · MCP reference

View your dashboard and profile, or change editable preferences after confirmation.

ntu onestop dashboard
ntu onestop profile show

Replace capitalized placeholders with values returned by the service. Use --help after a command for its current options. Choose a command to see its arguments, examples and result fields.

Command What it does
ntu onestop dashboard Read your One Stop homepage announcements, actions/payment links, upcoming appointments and popular links.
ntu onestop announcements Read One Stop announcements, summaries and links from the native announcements collection with local pagination.
ntu onestop actions Read your One Stop to-do/billing actions and their published due dates and payment links.
ntu onestop links List links on One Stop's Popular Sites page, preserving native catalog, knowledge and external destinations.
ntu onestop auth status Sign in to One Stop and report whether access is verified.
ntu onestop profile set Update one displayed editable own-profile field through its native inline editor.
ntu onestop profile picture Upload the explicitly selected local image as your own ServiceNow profile picture using the native file input.
ntu onestop profile notifications Enable or disable your ServiceNow notification preference.
ntu onestop profile preference Set an enabled own preference returned by get_profile.
ntu onestop profile show Read your own displayed profile fields, editable flags, preferences/choices, notification setting and picture-upload capability.

Command details

ntu onestop dashboard

Read your One Stop homepage announcements, actions/payment links, upcoming appointments and popular links.

Usage

ntu onestop dashboard

Use ntu onestop dashboard --help for the current interface.

Arguments and options

  • --json, -j: Write the result as JSON to stdout; diagnostics go to stderr.

Result

The result may include: retrieved_at, source_url, cached, announcements, actions, appointments, popular_links.

For the corresponding MCP operation and its field types, see the MCP schema.

ntu onestop announcements

Read One Stop announcements, summaries and links from the native announcements collection with local pagination.

Usage

ntu onestop announcements

Use ntu onestop announcements --help for the current interface.

Arguments and options

  • --limit, -l: Maximum number of results to return in this page. Default: 20.
  • --offset: Number of results to skip before this page. Default: 0.
  • --json, -j: Write the result as JSON to stdout; diagnostics go to stderr.

Result

The result may include: offset, available_count, total_count, complete, next_offset, retrieved_at, source_url, cached, records.

For the corresponding MCP operation and its field types, see the MCP schema.

ntu onestop actions

Read your One Stop to-do/billing actions and their published due dates and payment links.

Usage

ntu onestop actions

Use ntu onestop actions --help for the current interface.

Arguments and options

  • --limit, -l: Maximum number of results to return in this page. Default: 20.
  • --offset: Number of results to skip before this page. Default: 0.
  • --json, -j: Write the result as JSON to stdout; diagnostics go to stderr.

Result

The result may include: offset, available_count, total_count, complete, next_offset, retrieved_at, source_url, cached, records.

For the corresponding MCP operation and its field types, see the MCP schema.

List links on One Stop's Popular Sites page, preserving native catalog, knowledge and external destinations.

Usage

ntu onestop links

Use ntu onestop links --help for the current interface.

Arguments and options

  • --limit, -l: Maximum number of results to return in this page. Default: 20.
  • --offset: Number of results to skip before this page. Default: 0.
  • --json, -j: Write the result as JSON to stdout; diagnostics go to stderr.

Result

The result may include: offset, available_count, total_count, complete, next_offset, retrieved_at, source_url, cached, records.

For the corresponding MCP operation and its field types, see the MCP schema.

ntu onestop auth status

Sign in to One Stop and report whether access is verified.

Usage

ntu onestop auth status

Use ntu onestop auth status --help for the current interface.

Arguments and options

  • --json, -j: Write the result as JSON to stdout; diagnostics go to stderr.

Result

The result may include: credentials_configured, credential_storage, credential_error, session_verified, last_verified_at, session_storage, cache_ttl_seconds.

For the corresponding MCP operation and its field types, see the MCP schema.

ntu onestop profile set

Update one displayed editable own-profile field through its native inline editor.

This operation requires local confirmation and is refused when confirmation cannot be obtained interactively.

Usage

ntu onestop profile set FIELD_NAME VALUE

Replace the uppercase placeholders with values returned by the relevant listing or details command. Use ntu onestop profile set --help for the current interface.

Arguments and options

  • FIELD_NAME: Required. The name of the field to update.
  • VALUE: Required. The value to set for the named field or preference.
  • --json, -j: Write the result as JSON to stdout; diagnostics go to stderr.

Result

The result may include: operation, completed_at, source_url, resource_id, outcome, verified, message, references.

For the corresponding MCP operation and its field types, see the MCP schema.

ntu onestop profile picture

Upload the explicitly selected local image as your own ServiceNow profile picture using the native file input.

This operation requires local confirmation and is refused when confirmation cannot be obtained interactively.

Usage

ntu onestop profile picture /absolute/path/to/onestop-uploads/upload.pdf

Use ntu onestop profile picture --help for the current interface.

Arguments and options

  • FILE_PATH: Required. The path of the local file to upload.
  • --json, -j: Write the result as JSON to stdout; diagnostics go to stderr.

Result

The result may include: operation, completed_at, source_url, resource_id, outcome, verified, message, references.

For the corresponding MCP operation and its field types, see the MCP schema.

ntu onestop profile notifications

Enable or disable your ServiceNow notification preference.

This operation requires local confirmation and is refused when confirmation cannot be obtained interactively.

Usage

ntu onestop profile notifications on

Use ntu onestop profile notifications --help for the current interface.

Arguments and options

  • ENABLED: Required. Choose on to enable the setting or off to disable it. Choices: on, off.
  • --json, -j: Write the result as JSON to stdout; diagnostics go to stderr.

Result

The result may include: operation, completed_at, source_url, resource_id, outcome, verified, message, references.

For the corresponding MCP operation and its field types, see the MCP schema.

ntu onestop profile preference

Set an enabled own preference returned by get_profile.

This operation requires local confirmation and is refused when confirmation cannot be obtained interactively.

Usage

ntu onestop profile preference accessibility VALUE

Replace the uppercase placeholders with values returned by the relevant listing or details command. Use ntu onestop profile preference --help for the current interface.

Arguments and options

  • NAME: Required. The name of the item, setting or field to use. Choices: accessibility, voice_input, analytics, timezone, language, communication_channels.
  • VALUE: Required. The value to set for the named field or preference.
  • --json, -j: Write the result as JSON to stdout; diagnostics go to stderr.

Result

The result may include: operation, completed_at, source_url, resource_id, outcome, verified, message, references.

For the corresponding MCP operation and its field types, see the MCP schema.

ntu onestop profile show

Read your own displayed profile fields, editable flags, preferences/choices, notification setting and picture-upload capability.

Usage

ntu onestop profile show

Use ntu onestop profile show --help for the current interface.

Arguments and options

  • --json, -j: Write the result as JSON to stdout; diagnostics go to stderr.

Result

The result may include: retrieved_at, source_url, cached, fields, preferences, notifications_enabled, can_update_picture.

For the corresponding MCP operation and its field types, see the MCP schema.