Notion Note
Internal write-up in the Qraft Notion Tech subpage: infra, tooling, process, TMBA decks. Not communication — for the blog and the networks, use /publish.
Voice: .claude/knowledge/writing-style.md, universal voice + “Long-form” section. Read it before drafting.
Argument forms
/notion-note— write up the current session./notion-note ./notes/meeting-notes.md— turn those notes into a page./notion-note "topic"— write about that topic, ask clarifying questions if needed.
Workflow
- Gather context from the session, the file, or the topic.
- Propose a title, let Nicolas edit it.
- Draft in French.
- Sensitive-terms scan: write the draft to a scratchpad file and run
~/dev/claude/scripts/scan_sensitive.sh <file>. The page is internal: on exit 1, show the matches and ask whether they’re acceptable there. Exit 2 (terms list unreachable) → fail closed until the scan can run. - Create the page with the local Notion MCP: plain page (no database properties), parent page
189218ed56d78019b206d49417bafa31(Techin qrafttech), optional icon emoji matching the topic. - Return the page URL.
Images
The Notion MCP can’t upload files: use the REST API (Notion-Version: 2025-09-03) with NOTION_TOKEN_WORK from ~/.zshrc, never printed.
- Upload:
POST /v1/file_uploadswith{"filename", "content_type"}→id+upload_url, thenPOST <upload_url>as multipart (file=@shot.jpg) →status: uploaded. - Insert:
PATCH /v1/blocks/<page_id>/childrenwith{"after": "<block_id>", "children": [{"type": "image", "image": {"type": "file_upload", "file_upload": {"id": "…"}, "caption": […]}}]}. - Replace: the API can’t swap the file of an existing image block — insert the new one after it, then
DELETE /v1/blocks/<old_id>.