Can I perform destructive actions like deleting pages?

Yes, but the skill includes a mandatory safety protocol that requires explicit user confirmation before executing any delete, archive, or bulk update operations.

Which version of the Notion API does this skill use?

It is specifically optimized for the 2025-09-03 API version, supporting modern features like multiple data sources within a single database.

Does the skill manage Notion rate limits?

Yes, it includes guidance on handling HTTP 429 responses and implementing exponential backoff to stay within Notion's standard rate limits of 3 requests per second.

How does this skill handle Notion API keys?

The skill prioritizes the NOTION_API_TOKEN environment variable. If missing, it securely requests the key from the user and ensures it is never logged or exposed outside of the Authorization header.

Can I manage comments and discussions?

The skill supports retrieving comments from pages or blocks and creating new page-level comments or replies to existing discussions.

Notion API Integration

Name: Notion API Integration
Author: intellectronica

byintellectronica

•

195

•

Collaboration Tools

Automates interactions with the Notion API to manage pages, databases, blocks, and comments directly from Claude Code.

The Notion API Skill empowers Claude to act as a workspace assistant by providing comprehensive instructions for executing RESTful calls to Notion. It handles everything from secure authentication and rate limiting to complex operations like querying databases, creating nested page content, and managing comments. By utilizing standard command-line tools like curl and jq, it enables seamless synchronization and content management within Notion environments while strictly adhering to safety protocols for destructive operations and bulk data modifications.

Key Features

01Support for the latest 2025-09-03 API version and data sources

02Built-in safety confirmations for all destructive or bulk operations

03Automated authentication handling with environment variable support

04195 GitHub stars

05Advanced database querying with complex filtering and sorting

06Complete CRUD operations for Notion pages, databases, and blocks

Use Cases

01Extracting workspace content to inform AI coding and analysis tasks

02Generating and updating project documentation or status reports in Notion

03Syncing codebase tasks and ticket statuses with Notion databases

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add intellectronica/agent-skills notion-api

For use in Claude.ai and ChatGPT

Download Skill