notion-research-documentation

--- name: notion-research-documentation description: Research across Notion and synthesize into structured documentation; use when gathering info from multiple Notion sources to produce briefs, comparisons, or reports with citations. metadata: short-description: Research Notion content and produce briefs/reports --- # Research & Documentation Pull relevant Notion pages, synthesize findings, and publish clear briefs or reports (with citations and links to sources). ## Quick start 1) Find sources with `Notion:notion-search` using targeted queries; confirm scope with the user. 2) Fetch pages via `Notion:notion-fetch`; note key sections and capture citations (`reference/citations.md`). 3) Choose output format (brief, summary, comparison, comprehensive report) using `reference/format-selection-guide.md`. 4) Draft in Notion with `Notion:notion-create-pages` using the matching template (quick, summary, comparison, comprehensive). 5) Link sources and add a references/citations section; update as new info arrives with `Notion:notion-update-page`. ## Workflow ### 0) If any MCP call fails because Notion MCP is not connected, pause and set it up: 1. Add the Notion MCP: - `codex mcp add notion --url https://mcp.notion.com/mcp` 2. Enable remote MCP client: - Set `[features].rmcp_client = true` in `config.toml` **or** run `codex --enable rmcp_client` 3. Log in with OAuth: - `codex mcp login notion` After successful login, the user will have to restart codex. You should finish your answer and tell them so when they try again they can continue with Step 1. ### 1) Gather sources - Search first (`Notion:notion-search`); refine queries, and ask the user to confirm if multiple results appear. - Fetch relevant pages (`Notion:notion-fetch`), skim for facts, metrics, claims, constraints, and dates. - Track each source URL/ID for later citation; prefer direct quotes for critical facts. ### 2) Select the format - Quick readout → quick brief. - Single-topic dive → research s [... prompt truncated for preview ...]