███╗   ██╗ ██████╗ ████████╗██╗
 ████╗  ██║██╔═══██╗╚══██╔══╝██║
 ██╔██╗ ██║██║   ██║   ██║   ██║
 ██║╚██╗██║██║   ██║   ██║   ██║
 ██║ ╚████║╚██████╔╝   ██║   ██║
 ╚═╝  ╚═══╝ ╚═════╝    ╚═╝   ╚═╝

Your Notion workspace just got a brain.

Noti is a Claude Code skill that lets Claude read, write, search, and rearrange your Notion workspace like it owns the place. Need a page converted to Markdown? Done. Want to create 20 sub-pages from a research doc? Say the word. Upload a diagram? Already there.

No browser tabs. No copy-paste. No "let me just check Notion real quick." Just type /noti and go.

---

What it does

Command	What happens
noti list	Shows every page and database your integration can see
noti read <url>	Reads a page's full content — properties, body, everything
noti search <query>	Searches across your entire workspace
noti convert <url> [file]	Converts a Notion page to clean Markdown with YAML frontmatter
noti create <parent> <title> [md]	Creates a sub-page, optionally from a Markdown file
noti write <url> <file>	Appends Markdown content to an existing page
noti delete <id>	Archives a page or block
noti blocks <url>	Lists all block IDs in a page (for surgical edits)
noti link <parent> [after]	Inserts a linked list of child pages
noti icon <url> [--emoji] [--cover-url]	Sets page icon and/or cover image
noti image <url> <file> [caption]	Uploads a local image and adds it to a page

Page IDs, full Notion URLs, or UUIDs — noti eats them all.

As Claude Code skills

Skill	What it does
/noti	Master mode — researches, cross-checks, asks before writing
/noti-list	List pages and databases
/noti-read <url>	Read a page
/noti-search <query>	Search the workspace
/noti-convert <url> [file]	Page to Markdown
/noti-write <parent> <file>	Create or append content

Install

bash skill/install.sh

The installer will:

1. Ask for your Notion API key (or reuse the existing one)
2. Copy the runtime to ~/.claude/tools/noti/
3. Install dependencies
4. Register all /noti-* skills in ~/.claude/skills/

Getting a Notion API key

1. Go to notion.so/my-integrations
2. Create a new integration — enable Read, Update, and Insert content
3. Copy the Internal Integration Token (ntn_...)
4. Share pages with your integration: Page → ··· → Connections → Add your integration

Architecture

~/.noti/config.json              Your API key lives here
~/.claude/tools/noti/            Runtime (index.js + node_modules)
~/.claude/skills/noti-*/         Skill definitions (one SKILL.md per command)

Config precedence: ~/.noti/config.json > ~/.claude/tools/noti/.env > process.env

Dependencies

Just two:

• @notionhq/client — official Notion SDK
• dotenv — env fallback

No frameworks. No build step. One file. index.js does everything.

Development

cd skill/
NOTION_API_KEY=ntn_... node index.js list
NOTION_API_KEY=ntn_... node index.js search "my page"
NOTION_API_KEY=ntn_... node index.js convert <page-url> output.md

License

MIT

---

Built by Turing Labs — because alt-tabbing to Notion is a skill issue.