Notion Knowledge Capture

Knowledge Capture

Convert conversations and notes into structured, linkable Notion pages for easy reuse.

Notion MCP setup (only if MCP calls fail)

1. codex mcp add notion --url https://mcp.notion.com/mcp
2. Set [features].rmcp_client = true in config.toml
3. codex mcp login notion — then restart Codex.

Rules

1) Classify the capture

• Ask: purpose, audience, freshness, and new-or-update.
• Content types: decision, how-to, FAQ, wiki entry, learning note, documentation page.

2) Find the target database

• Search with Notion:notion-search, then fetch with Notion:notion-fetch to confirm the database schema.
• Required properties to verify before creating pages:
  • All types: title, tags, owner, status, created date
  • Decisions: additionally need: alternatives (rich text), outcome (select), rationale (rich text)
  • How-tos: additionally need: prerequisites (rich text), steps (rich text)
  • FAQs: additionally need: question (title), answer (rich text)
• If multiple candidate databases exist, ask the user. Otherwise use the primary wiki/docs DB.

3) Extract and structure

• Decisions: record alternatives considered, rationale, and outcome.
• How-tos: capture steps, prerequisites, links to assets/code, and edge cases.
• FAQs: phrase as Q&A with concise answers; link to deeper docs.
• Wiki/docs: summarize the concept, add context, and link related pages.

4) Create in Notion

• Use Notion:notion-create-pages with the database's data_source_id. Set all verified properties.
• If updating an existing page, fetch first, then edit via Notion:notion-update-page.

5) Link and surface

• Add relations/backlinks to hub pages and related records.
• Include a summary for future readers. Create follow-up tasks if needed.