Skip to content
TakoAPI
Back to skills

better-notion

by tyler6204

Notes & PKM
—Not yet rated
Your rating

Brief

Full CRUD for Notion pages, databases.

Description

What This Skill Does

Full CRUD for Notion pages, databases, and blocks via the Notion REST API. Supports create, read, update, delete, search, and filtered database queries. API key is stored locally and passed as a bearer token on each request.

Enables scripted or automated Notion changes without opening the app, making bulk updates and pipeline integrations practical.

When to Use It

  • Add a new task entry to a Notion project database
  • Query all records in a database filtered by status or property
  • Append text blocks to an existing Notion page
  • Search across all Notion content by keyword
  • Update a page property like status, date, or checkbox

Example Workflow

INPUT

User asks: Create a new task called 'Review PR #42' with status Active in my Tasks database

AGENT
  1. 1

    Search Notion for the Tasks database to retrieve its data_source_id

  2. 2

    Construct a create-page request with the title and Status select property set to Active

  3. 3

    POST to /v1/pages with the database parent and properties payload

  4. 4

    Return the new page ID and URL from the API response

OUTPUT

New Notion page 'Review PR #42' created in the Tasks database with Status set to Active

Requirements

  • Notion API key generated from the Notion integrations settings page
  • Notion integration connected and shared with the target pages or databases in the Notion UI

Installation

clawhub install tyler6204/better-notion

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links