notion

This skill allows you to interact with the Notion API, enabling you to create, read, update, and delete pages, databases (data sources), and blocks within your Notion workspace. It provides a comprehensive set of tools for automating content management, data organization, and workflow integration.

With this skill, you can programmatically search for content, retrieve page content, create new pages within databases, query databases based on specific criteria, and update existing page properties. It leverages the latest Notion API version (2025-09-03) and provides clear instructions for setup and common operations.

The skill also highlights key differences in the 2025-09-03 API version, such as the renaming of 'Databases' to 'Data Sources', and the introduction of separate `database_id` and `data_source_id` fields, ensuring compatibility and efficient data management.

What It Does

Enables programmatic interaction with the Notion API for creating, reading, updating, and deleting pages, databases, and blocks.

When To Use

Use this skill to automate content management in Notion, integrate Notion data with other applications, build custom workflows, or programmatically manage Notion databases.

Limitations

Installation

1. Create a Notion integration at https://notion.so/my-integrations.
2. Copy the API key (starts with `ntn_` or `secret_`).
3. Store the API key in `~/.config/notion/api_key` (create the file if it doesn't exist).
4. Share the target Notion pages/databases with your integration.

1. Create a Notion integration at https://notion.so/my-integrations.
2. Copy the API key (starts with `ntn_` or `secret_`).
3. Store the API key in `~/.config/notion/api_key` (create the file if it doesn't exist).
4. Share the target Notion pages/databases with your integration. Ensure Cursor has file access permissions.