# Notion API

Searches, reads and writes Notion pages and databases, and adds rows and content for you.

- Kind: a skill for AI agents
- Version: 1.0, updated 2026-11-18
- Shared by: Workotron
- Written by: [Anthropic](https://github.com/anthropics/claude-tag-plugins/tree/b6ee25f8f00a291cbdf31eb75bd7cc1a987d6782/notion/skills/notion-api)
- License: Apache-2.0
- Business area: Productivity
- Tags: #productivity #claude
- Rank: not ranked yet, with 0 copies, 0 thumbs up and 0 thumbs down
- Permanent address: https://skills.workotron.com/notion-api

## Who is this for?

- Small teams that keep notes, plans and lists in Notion
- People who want an AI agent to find, read or update their Notion pages

## What it does

- Searches page and database titles across what the integration can see
- Reads a page's full content, including nested blocks
- Reads a database's fields and queries its rows with filters and sorting
- Adds rows to a database and creates pages under other pages
- Updates page properties and adds new content to a page

## When to use it

- When you want to find a page in Notion or ask what is in it
- When you need a new row added to a Notion database
- When you want notes or to-dos added to an existing page

## About this skill

It works through the Notion API and expects the AI tool it runs in to supply the integration key. Notion only shows the integration pages you have shared with it, so a missing page often means it was not shared. Search matches titles only, not page text.

It runs two bundled shell scripts on your computer, built on curl and jq: one searches the workspace and one reads a page's content. It treats text inside pages as data and does not follow instructions found there.

## Supported platforms

- Workotron
- Claude

## Install

Get https://skills.workotron.com/notion-api.zip and extract it into your skills folder. If you cannot unzip, get each file:

- https://skills.workotron.com/notion-api/files/LICENSE.txt
- https://skills.workotron.com/notion-api/files/SKILL.md
- https://skills.workotron.com/notion-api/files/references/api.md
- https://skills.workotron.com/notion-api/files/scripts/notion_read_page.sh
- https://skills.workotron.com/notion-api/files/scripts/notion_search.sh

## Discussion (0)
