Privacy settings

Essential preferences (always on)

Saves your language and privacy preferences. These settings are not used for analytics or advertising.

Uses Cloudflare to understand page views and loading performance and improve the site. Turning this off stops information being sent for this analytics service.

Displays the Notion contact form. Enabling it connects to Notion, which may use cookies and similar technologies. You can contact us by email with this setting off.

Your choice is remembered in this browser for six months. You can change it at any time from Privacy settings in the footer.

Cookies and external services

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