Skip to content

Command Line Interface

When Ultimate Notion is installed, a new command uno becomes available in your virtual environment. This command provides quick access to configuration and integration information.

Usage

The CLI currently supports the following operations:

  • Configuration management - View your current configuration file location and contents
  • Integration information - Display details about your Notion integration and environment
  • File uploads - Upload files to Notion pages with automatic block type detection
  • System diagnostics - Check version information and workspace details

To see all available commands and options:

uno --help

Shell Auto-completion

The CLI supports shell auto-completion for faster command entry. Install it with:

uno --install-completion

Available Commands

config

Display the current configuration file path and contents:

uno config

info

Display information about your Notion integration, including version details and workspace information:

uno info

upload

Upload a file to a Notion page and automatically append it as the appropriate block type:

uno upload <file_path> <page_name_or_uuid>

The command automatically detects the file type and creates the appropriate block:

  • Images (.png, .jpg, .jpeg, .gif, .webp, etc.) → Image block
  • Videos (.mp4, .avi, .mov, .wmv, etc.) → Video block
  • PDFs (.pdf) → PDF block
  • All other files → File block

Examples

Upload an image to a page by name:

uno upload screenshot.png "My Project Notes"

Upload a PDF to a page by UUID:

uno upload document.pdf 12345678-1234-1234-1234-123456789abc

Upload a video file:

uno upload demo.mp4 "Product Demo Page"

Options

The CLI supports a --log-level option to control output verbosity. Available levels are critical, error, warning (default), info, and debug.

uno --log-level debug info

Upload Command Logging

The upload command shows detailed progress information when using --log-level info or --log-level debug. This includes file upload progress, page lookup details, and file URLs. By default, only success messages and errors are shown.

uno --log-level info upload document.pdf "My Page"

For detailed help on any command, use:

uno <command> --help