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

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
• Audio (.mp3, .wav, .ogg, .m4a, etc.) → Audio block
• PDFs (.pdf) → PDF block
• All other files → File block

Check out all supported file types in the Notion docs.

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

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

For detailed help on any command, use:

uno <command> --help