notion-integration

Search, create, and write Notion pages and database entries via the Notion API.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/erwinv2k-TKG/AgentesVSC --skill notion-integration-erwinv2k-tkg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion-integration
Source: https://github.com/erwinv2k-TKG/AgentesVSC/tree/main/packs/incidentfox/sre-agent/.claude/skills/docs-notion
Command: npx skills add https://github.com/erwinv2k-TKG/AgentesVSC --skill notion-integration-erwinv2k-tkg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires httpx, and includes scripts (resource) components.

What problem does it solve? Managing Notion documentation manually during incident response or knowledge work is slow and error-prone. This Skill lets you search existing pages, create new pages under parents or databases, and append or replace page content directly from the command line. ## Core Features & Use Cases - Page Search: Query Notion workspaces by keyword and retrieve page IDs, titles, URLs, and last-edited timestamps. - Page Creation: Create pages under a parent page or as entries in a Notion database, with optional initial paragraph content. - Content Writing: Append new paragraph blocks to a page or fully replace existing content. - Use Case: After resolving an incident, search Notion for the relevant runbook, then create an incident report page under the team database and write the postmortem summary into it automatically. ## Quick Start Ask the agent to search Notion for the incident runbook and create a new incident report page under it with your summary content.

Frequently Asked Questions about notion-integration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Notion pages from the command line?

Run the search.py script with a --query argument and optional --max-results limit. It calls the Notion /search endpoint and prints matching page titles, IDs, URLs, and last-edited timestamps, with a --json flag for structured output.

How to create a Notion page in a database with Python?

Use create_page.py with --parent-database-id and a --title, optionally adding --content for initial paragraphs. The script builds the Notion API parent and properties payload and returns the new page ID and URL.

Does this Notion integration require an API key?

Credentials are injected automatically by a proxy layer, so scripts run directly without manual setup. Alternatively, set NOTION_API_KEY, or use SANDBOX_JWT or tenant and team ID environment variables for authentication headers.

Can I replace existing content on a Notion page?

Yes, write_content.py supports a --replace flag that deletes all existing child blocks before appending new paragraph content. Without the flag, content is appended to the end of the page.

What content types can be written to Notion pages?

The scripts write plain paragraph blocks only, splitting input text on double newlines into separate paragraphs. Rich block types like headings, tables, or code blocks are not supported by these scripts.