Toukan CLI Setup Guide

A CLI tool to operate Toukan from your terminal. Install via Homebrew and integrate it into your development workflow.

Prerequisites

  • macOS 14.0 (Sonoma) or later
  • Homebrew installed
  • Mac App Store version of Toukan is not required (CLI works standalone)
    * Install separately if you want to use both the GUI and CLI

Installation

brew install bon-clevique/tap/toukan

Verify the installation:

toukan --version

Initial Setup

Run toukan setup to start the interactive setup wizard.

  1. Enter your Notion API token (input is masked)
  2. Select the folder to sync
  3. Enter and verify your Notion data source ID
toukan setup

Command Reference

Command Description
toukan setup Interactive setup wizard
toukan list List sync targets
toukan add <folder> --data-source <id> Add a sync target
toukan remove <folder> Remove a sync target
toukan status Show configuration and folder statistics
toukan sync Sync all targets
toukan sync <files...> Sync specific files only

Claude Code Integration

For developers using Claude Code, Toukan provides a command to automatically install a reference document. 

toukan config install-claude-ref

This places a file at ~/.claude/rules/toukan.md, enabling Claude Code to reference Markdown output rules when working with Toukan.

Updating

brew upgrade toukan

Troubleshooting

Reset your Notion token 
toukan config set notion-token
Check your configuration 
toukan status
Files are not syncing

Check the following:

  • Folder access permissions
  • Notion data source sharing settings
  • Whether toukan status reports any errors

Related Links