martin-hausleitner/martins-awesome-skills/notion

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Use when reading, creating, updating, or organizing Notion pages and databases through the Notion API

Install

npx vskill@latest install martin-hausleitner/martins-awesome-skills/notion

SKILL.md

Notion

Overview

Use Notion as a structured workspace through its API. Keep integrations narrow, explicit, and easy to revoke.

Setup

  1. Create a Notion integration in the Notion developer settings.
  2. Store the token outside the repo:
bash
export NOTION_API_KEY="YOUR_NOTION_TOKEN"
export NOTION_VERSION="YYYY-MM-DD"
  1. Share only the needed pages or databases with the integration.
  2. Verify access with a read-only request before writing.

Common Requests

Search:

bash
curl -s -X POST "https://api.notion.com/v1/search" \
-H "Authorization: Bearer $NOTION_API_KEY" \
-H "Notion-Version: $NOTION_VERSION" \
-H "Content-Type: application/json" \
-d '{"query":"project notes"}'

Read page blocks:

bash
curl -s "https://api.notion.com/v1/blocks/PAGE_ID/children" \
-H "Authorization: Bearer $NOTION_API_KEY" \
-H "Notion-Version: $NOTION_VERSION"

Safety

  • Do not commit Notion tokens, page IDs for private workspaces, exports, or database dumps.
  • Ask before creating, editing, deleting, or publishing pages.
  • Prefer small updates over replacing whole pages.

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
5

Refreshed 20 Oct 2026, 3 days ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/martin-hausleitner/martins-awesome-skills/notion/badge)](https://verified-skill.com/skills/martin-hausleitner/martins-awesome-skills/notion)

Something wrong with this skill or its page? Tell us.