Installation

Install via BRAT (Recommended)

While N2O finishes the community directory review, the easiest way to install is with BRAT:

1. Install the BRAT plugin from Obsidian’s Community Plugins.
2. Open BRAT settings and click Add Beta Plugin.
3. Enter the repository URL: https://github.com/n2osync/n2o
4. BRAT will install N2O and keep it updated automatically.

After enabling N2O, open its panel from the ribbon icon - you’ll see the connect screen:

Manual Install (GitHub Releases)

1. Go to the N2O Releases page.
2. Download all four files from the latest release:
   • main.js - plugin code
   • styles.css - plugin styles
   • manifest.json - plugin metadata
   • sql-wasm.wasm - SQLite engine (required for the sync database)
3. In your vault, create the folder .obsidian/plugins/n2o/.
4. Copy all four downloaded files into that folder.
5. Restart Obsidian and enable N2O in Settings > Community Plugins.

From Obsidian Community Plugins

Once N2O is listed in the Obsidian community directory (coming soon):

1. Open Settings in Obsidian.
2. Go to Community Plugins and click Browse.
3. Search for “N2O” (or “Notion to Obsidian Sync”).
4. Click Install, then Enable.

System Requirements

• Obsidian 1.4+ (desktop only - Windows, macOS, Linux)
• A Notion account connected via OAuth or an integration token
• Internet connection for syncing with Notion’s API

Note

Database views are generated as Obsidian Bases files. Bases is a core Obsidian plugin available in Obsidian 1.9+, so you need 1.9 or later to see the generated .base views. Everything else works on 1.4+.

Next Steps

Once installed, connect your Notion account.