Write in Obsidian. Share in Notion. Hand it to your AI. Notional is a free, open-source Obsidian plugin that pushes and pulls your Markdown notes to Notion — links intact, structure preserved, nothing overwritten by surprise — turning your private vault into a knowledge base that Claude, ChatGPT, and any Notion-aware agent can read.
View on GitHub Download latest releaseToday's AI assistants split along one line. Local agents — Claude Code, Hermes, Cursor — read and write the Markdown in your vault directly. Cloud agents — OpenClaw, plus the Notion connectors and MCP (Model Context Protocol) integrations now built into Claude and ChatGPT — reach your knowledge through Notion's API. Obsidian has no official cloud API; Notion does. Notional is the bridge that lets both sides work from the same source of truth.
Push the folders you choose to Notion and any Notion-aware agent can search, summarize, and cite your notes — without exposing your whole vault. You decide exactly what the AI sees.
A Discord or Telegram agent drops research and ideas into Notion on the go; Pull brings them home to the vault where you do deep work — same notes, both places.
Let Claude Code or Hermes draft summaries and outlines as Markdown, then push them to Notion as clean pages your team — or your next agent — can act on. Pull the edits back anytime.
If an AI changes a Notion page and you changed the same note locally, Notional stops and asks instead of overwriting — so handing pages to agents never quietly costs you work.
You think in Obsidian — it is fast, private, and yours. But your
clients, teammates, and shared wikis live in Notion. Copy-pasting
between them breaks your [[wiki-links]], flattens
nested outlines, and leaves you with stale duplicates. Notional
ends the copy-paste tax: one command and your note lands in Notion
looking the way it should.
Push notes to Notion and pull teammates' edits back into Obsidian. Sync picks the right direction automatically.
Your [[internal links]] become real,
clickable Notion page mentions — not dead plain text.
If both sides changed, Notional stops and asks which version to keep. No surprise data loss, ever.
One-click OAuth connect. Your token stays on your device and talks only to Notion — there is no server in the middle.
Push a single note or a whole project folder at once, with scoped control over exactly what goes public.
Headings, checklists, tables, callouts, toggles, code, and deep nesting are preserved both ways.
Full setup guide on the GitHub README.
Install the Notional plugin from Obsidian's community plugin browser, connect your Notion workspace with an API token or one-click OAuth, then use the Push, Pull, and Sync commands on any note. Notional handles Markdown-to-Notion conversion and keeps both sides in sync.
Yes — it's a sweet spot. Local agents (Claude Code, Hermes) work directly on your Obsidian Markdown, while cloud agents reach knowledge through Notion's API. Notional syncs the two, so you can publish AI-drafted notes from Obsidian to Notion, expose a scoped slice of your vault as an AI-readable second brain, and pull agent edits back — without silent overwrites.
Yes. Notional is completely free and released under the GNU GPL v3.0. The full source is on GitHub.
True two-way sync. You can push Markdown notes to Notion and pull Notion edits back into Obsidian. When both sides change, Notional asks you which version to keep rather than guessing.
Yes. Notional runs entirely on your device. Your notes and Notion token never touch a third-party server — they go directly from your machine to the Notion API. See the privacy policy.
[[wiki-links]] are converted into clickable
Notion page mentions, and deeply nested outlines are uploaded
past Notion's per-call block limit — so your structure
survives the trip.