Notion
Skill Martin-Hausleitner/martins-awesome-skills/skills/productivity/notion
Martin's Awesome Skills: public-safe Hermes and OpenClaw agent skills with Telegram approval workflows
npx -y skills add Martin-Hausleitner/martins-awesome-skills --skill notionAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Use when reading, creating, updating, or organizing Notion pages and databases through the Notion API
SKILL.md
1.2 KB, as published. Nobody here has run it
Notion
Overview
Use Notion as a structured workspace through its API. Keep integrations narrow, explicit, and easy to revoke.
Setup
- Create a Notion integration in the Notion developer settings.
- Store the token outside the repo:
export NOTION_API_KEY="YOUR_NOTION_TOKEN"
export NOTION_VERSION="YYYY-MM-DD"
- Share only the needed pages or databases with the integration.
- Verify access with a read-only request before writing.
Common Requests
Search:
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:
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.