agentsclimarketplace
Sign in

Notion

Skill Martin-Hausleitner/martins-awesome-skills/skills/productivity/notion

Use when reading, creating, updating, or organizing Notion pages and databases through the Notion APIFrom its SKILL.md

Install
npx -y skills add Martin-Hausleitner/martins-awesome-skills --skill notion

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

4 things to look at

  • reads credentialsReads from 1 credential source: `NOTION_API_KEY`.
  • 3 stars3 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.
  • runs commandsInstructs the agent to run 2 commands, including `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"}'` and 1 more.
  • fetches URLsInstructs the agent to fetch 2 URLs, including https://api.notion.com/v1/search and 1 more.

SKILL.md

1.2 KB, 290 tokens by cl100k_base, 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

  1. Create a Notion integration in the Notion developer settings.
  2. Store the token outside the repo:
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:

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.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.