notionmemory 0.1.0

Notion as a second-brain hub for coding agents: memory, calendar, templates, and library skills.

notionmemory

Turn Notion into a second-brain hub for coding agents (Claude Code, Codex). notionmemory ships a set of installable skills — long-term memory, calendar, templates, and library recall — plus session hooks that surface the right context automatically.

Skills and CLI onboarding output are available in English (default) and Korean (config language: en|ko). A longer Korean guide is at docs/README.ko.md.

Install

1. Backend (required, both harnesses):

pipx install notionmemory      # or: uv tool install notionmemory / pip install --user notionmemory

2a) Claude Code (plugin):

/plugin marketplace add legojeon/notionmemory
/plugin install notionmemory@notionmemory
# skills appear as notionmemory:calendar, notionmemory:memory, …
# Do NOT also run `notionmemory install --claude` (the plugin already installs skills + hooks).

2b) Codex (plugin + hooks):

codex plugin marketplace add legojeon/notionmemory
codex plugin add notionmemory@notionmemory
notionmemory install --codex --skip-skills --trust-codex-hooks   # hooks + trust (plugin owns the skills)
# --skip-skills: don't mirror skills, the plugin already provides them
# --trust-codex-hooks: required or Codex will silently not fire the installed hooks

Prefer no plugin? One uniform command sets up both harnesses (skills unnamespaced):

pipx install notionmemory && notionmemory install

Codex users: notionmemory install will tell you to also run notionmemory install --codex --trust-codex-hooks before Codex hooks fire.

The marketplace source is this repository. If you're working from a local clone before it's reachable as legojeon/notionmemory, add it by path instead: codex plugin marketplace add "$(pwd)" / claude plugin marketplace add "$(pwd)".

Run notionmemory serve to open the settings dashboard and connect your Notion token (stored in your OS keyring, never in config).

Skills

• memory — save/recall long-term decisions & patterns in a Notion Second Brain
• calendar — read/create/move events in a Notion calendar DB
• templates — CRUD over your registered Notion templates & databases
• library — content search across your Notion pages
• settings — local web dashboard for connections & configuration

Upgrade

notionmemory installs files on your system (skill mirrors, session/git hooks, state). To upgrade cleanly — including removing skills that a new version has retired — run notionmemory teardown then reinstall. teardown removes only what it installed; your Notion pages, config, and keyring token are preserved by default (see notionmemory teardown --dry-run).

Uninstall

notionmemory teardown              # removes skills, hooks, local state
notionmemory teardown --purge-config --purge-secrets   # also config + token

Notion databases and pages are never deleted.

License

MIT — see LICENSE.