login
kevinslin

notion

by @kevinslin in Tools
0
0
# Install this skill:
npx skills add kevinslin/notion-agent-skill

Or install specific skill: npx add-skill https://github.com/kevinslin/notion-agent-skill

# Description

This skill should be used when the user wants to do anything with notion. should always be used before calling notion mcp

# SKILL.md

name: notion
description: This skill should be used when the user wants to do anything with notion. should always be used before calling notion mcp

When to Use This Skill

Use this skill when the user wants to:
- Add entries to Notion databases
- Create new Notion pages with structured data
- Save content from Dendron notes to Notion
- Track daily stories, tasks, lessons, or other personal data in Notion

Using the CLI

Read ./scripts/notion/USAGE.md for usage guide

Setup

  1. Make sure that NOTION_TOKEN is set. If not, stop and tell user to set it.
  2. Check that $HOME/.notion-cache.production.json is accessible. If not, run `notion sync-meta and verify that the file is created

Shortcuts

add-block

  1. User will supply a database and a block. If this is missing or you're not sure, ask user to confirm before proceeding.
  2. Use CLI parseBlock to extract strucutred output
    Important: Default to printf pipeline for parse operations in restricted shells, and validate parse output before reporting it
  3. Use the CLI create command with structured output to create a new entry

# README.md

Notion skill

Notion skill and CLI that let you create pages, sync notes, and manage database metadata in a Notion workspace.
It works by providing a Codex skill definition plus a Node CLI in scripts/notion that talks to the Notion API.

What it enables

  • Create pages in Notion databases with structured properties and markdown bodies.
  • Sync local notes into Notion using rule files.
  • Cache database metadata for fast lookups.
  • Parse markdown blocks into structured payloads for automation.

Quickstart

cd scripts/notion
npm install
export NOTION_TOKEN=secret_xxx
node notion.js list-db --limit 5 --format table

If you install the local bin, you can replace node notion.js with notion.

Setup

  • Set NOTION_TOKEN (or NOTION_API_KEY) in the environment or a .env file.
  • Run node notion.js sync-meta once to create $HOME/.notion-cache.production.json.

Skill usage

Use this skill when you want to:

  • Add entries to Notion databases.
  • Create new Notion pages with structured data.
  • Save content from Dendron notes to Notion.
  • Track daily stories, tasks, lessons, or other personal data in Notion.

Common commands

# List databases
node notion.js list-db --limit 10 --format table

# Create a page
node notion.js create --database-id <db-id> --properties Name="Daily note" --properties Date=2026-01-29

# Sync metadata cache
node notion.js sync-meta

# Sync notes using rules
node notion.js sync --dry-run

Full CLI reference lives in scripts/notion/USAGE.md.

add-block shortcut

Create a database entry from a single markdown block.

  1. Confirm the target database and the block content.
  2. Parse the block into { title, properties, body } using parse-block (prefer printf piping).
  3. Use create with the parsed output to create the entry.
printf "%s" "## Weekend grocery reminder
- time: 08:25
- source: SMS

Please pick up apples, oats, and milk on the way home." | node notion.js parse-block

Tests

cd scripts/notion
npm test

# Related Skills

obra
executing-plans @obra

Use when you have a written implementation plan to execute in a separate session with review checkpoints

β˜… 32,766
obra
using-superpowers @obra

Use when starting any conversation - establishes how to find and use skills, requiring Skill...

β˜… 32,766

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚑ Amp πŸš€ Antigravity πŸ€– Claude Code πŸ¦€ Clawdbot πŸ“ Codex ▢️ Cursor πŸ€– Droid πŸ’Ž Gemini CLI πŸ™ GitHub Copilot πŸͺΏ Goose πŸ“Š Kilo Code πŸ”§ Kiro CLI πŸ’» OpenCode 🦘 Roo Code 🌲 Trae πŸ„ Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.