What is notion-importer?

A workflow for importing Notion, a workspace for documents and notes, into a project's local documentation vault through a connection to Notion.

Use it to import or synchronise configured Notion pages into the project's documentation folder.

It keeps selected Notion pages available in the project and records where the imported content came from.

notion-importer — Skill for Claude Code and Codex by Enakoneschniy

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add Enakoneschniy/claude-dev-stack --skill notion-importer

Clone the repo

git clone --depth 1 https://github.com/Enakoneschniy/claude-dev-stack

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/enakoneschniy/claude-dev-stack/notion-importer.svg)](https://agentmods.dev/skills/enakoneschniy/claude-dev-stack/notion-importer)

Your own site

<a href="https://agentmods.dev/skills/enakoneschniy/claude-dev-stack/notion-importer"><img src="https://agentmods.dev/badge/skills/enakoneschniy/claude-dev-stack/notion-importer.svg" alt="Measured on agentmods" height="20"></a>

Per session 96 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 890 The whole file, excluding the scripts and references it only reads on demand.

Security scan B 2 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00096	$0.00890
Opus 5	$0.00048	$0.00445
Sonnet 5	$0.00019	$0.00178
Haiku 4.5	$0.00010	$0.00089

Measured 8d ago against content hash 003a2275254d, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade B, and why

notion-importer scanned grade B with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

cat .claude/notion_pages.json

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

notion-fetch(page_id: "<page_id>")

skills/notion-importer/SKILL.md · 89 lines

How it starts

The opening of the file, as written. The whole thing — 89 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Notion Importer Skill

Import Notion pages into the project vault using the claude.ai Notion MCP server. This skill calls MCP tools directly from a live Claude session — no subprocess needed.

Trigger Phrases

English: "import notion", "notion docs", "sync notion", "sync notion pages", "import notion pages" Russian: "импортируй notion", "обнови notion", "обнови notion docs", "синхронизируй notion"

Required Setup

The project must have .claude/notion_pages.json configured. Run claude-dev-stack notion add <url> to add pages.

Import Steps

Read config: Load .claude/notion_pages.json to get the list of pages.

cat .claude/notion_pages.json

Fetch each page: For each page in config.pages, call the notion-fetch MCP tool with the page_id to retrieve markdown content. Use the MCP tool directly:

notion-fetch(page_id: "<page_id>")

Or use notion-search MCP tool if you need to locate pages by title.

Determine vault path: Use the vault_path field from the page config (default: docs/notion). Resolve against the vault project directory: vault/projects/{project-slug}/docs/notion/
Write with provenance: Each imported file gets a frontmatter stamp:

---
notion_page_id: <page_id>
notion_last_synced: <ISO timestamp>
notion_content_hash: <SHA-256 of content below frontmatter>
---

<page content>

3-way hash check (overwrite protection, per D-06):
- If file does not exist → create it with stamp (status: created)
- If notion_content_hash in frontmatter matches hash of new content → skip (status: unchanged)
- If local body hash matches stored notion_content_hash (no local edits) → overwrite in place (status: updated)
- If local body hash differs from stored notion_content_hash (local edits detected) → write {filename}.notion-update.md sibling and warn (status: conflict)
Filename convention: Use the page title for the filename, cleaned with the same rules as cleanNotionFilename() in lib/docs.mjs — strip Notion UUID suffixes, lowercase, replace spaces with hyphens. Example: My Page abc123... → my-page.md

Read the full file on GitHub · 89 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

8d ago First seen · 89 lines · 96 tokens per session scan B 003a2275254d

Subscribe to this mod's changes

notion-importer is a skill published in the GitHub repository Enakoneschniy/claude-dev-stack (5 stars, last pushed 3d ago), licensed MIT. It adds 96 tokens to every session and 890 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it B with 2 findings (reads agent configuration directories, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Claude Code Documents ai-development claude-skills cli developer-tools obsidian

joycraft-add-fact

Invoked by session-end or the human after a fact surfaces — route it to the correct context document (production map, dangerous assumptions, decision log, institutional knowledge, troubleshooting).

maksutovic/joycraft · 41 tokens

long-doc-governance

A set of rules for managing long documents by checking their length and splitting them when substantial changes would make them too large.

BackToCimaCoppi/Praxis · 115 tokens

doc-html-style

A manually triggered style guide for turning settled content into a self-contained HTML technical document designed mainly for desktop reading.

BackToCimaCoppi/Praxis · 68 tokens

bmad-shard-doc

Splits large markdown documents into smaller, organized files based on level 2 (default) sections. Use if the user says perform shard document.

LarsCowe/bmalph · 34 tokens

ai-image-to-pptx

A workflow that creates a set of related images with AI and places them into a real PowerPoint file. The resulting .pptx file can be opened and edited in PowerPoint, Keynote, or WPS.

huangrichao2020/pretty-skills · 93 tokens

notion-cli

Work with Notion from the terminal using the notion CLI. Use when the user needs to read, create, update, query, or manage Notion pages, databases, blocks, comments, users, or files programmatically. Covers the entire Notion API with 50+ commands. Triggers: Notion workspace automation, database queries, page creation…

4ier/notion-cli · 109 tokens

notion-importer