skills.rest
FahadImdad
FahadImdadCOMMUNITY
Explore all skills by this author →
GitHub

notion-master

Provides shared scripts and references for Notion API integration skills.

Updated Jan 22, 2026
Search Tags:#automation#database#api#integration#python#notion#query
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill notion-master-fahadimdad
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion-master
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/notion/notion-master
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill notion-master-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve? Notion integration skills duplicated the same setup guides, API documentation, and error handling content across multiple skills, wasting context and creating maintenance overhead. This shared resource library centralizes common Notion references and scripts so related skills load them on demand. ## Core Features & Use Cases - Shared Script Library: Provides 13 Python scripts covering configuration checks, database discovery, querying, page/block/user/comment management, and skill import/export via the Notion API. - Consolidated References: Includes setup guides, API documentation, database schema, filter syntax, property types, block types, and error handling references loaded progressively by dependent skills. - Intelligent Error Detection: The config checker outputs structured JSON with an ai_action field so the AI can guide users through fixing missing API keys or incomplete setup. - Use Case: When a user asks to query a Notion database, the notion-connect skill loads this library's check_notion_config.py to validate setup, then runs search_skill_database.py to execute the query. ## Quick Start Ask the AI to query one of your Notion databases and it will use this library's scripts through the notion-connect skill.

Frequently Asked Questions about notion-master

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

FAQPage Schema
How do I query a Notion database with Python?▼

Use the search_skill_database.py script with the --db flag specifying a database name or ID, plus optional --filter, --sort, and --limit arguments. It calls the Notion POST /databases/{id}/query endpoint and supports fuzzy database name matching.

How do I set up a Notion API key for integration?▼

Run setup_notion.py for an interactive wizard, or manually add NOTION_API_KEY and NOTION_SKILLS_DB_ID to a .env file. Get an API key by creating an integration at notion.so/my-integrations and copying the Internal Integration Secret.

Why does my Notion API request return a 401 error?▼

A 401 error means the API key is invalid or expired. Run check_notion_config.py to validate your credentials, then verify the key in your .env file matches an active integration in your Notion workspace settings.

What file types can I upload to Notion via the API?▼

Notion supports txt, json, pdf, doc, docx, xls, xlsx, ppt, pptx, images, audio, and video up to 5 MB per file. Zip and md files are rejected, so rename .md files to .txt before uploading.

How do I handle Notion API rate limits?▼

Notion limits requests to 3 per second per integration and returns HTTP 429 when exceeded. The rate_limiter.py module provides exponential backoff with jitter and respects the Retry-After header for automatic retries.

Related Skills

Explore More Software Engineering Skills→
LuisvelMarketerLuisvelMarketer
1

notion

Manage Notion pages, databases, and blocks via the Notion API.

Community
Intermediate
abdullahbeamabdullahbeam
2

import-skill

Import skill assets from Notion databases into local Nexus directories.

Community
Advanced
whmathews15whmathews15
1

health-check

Diagnose Dex MCP health issues from cached pre-flight checks and error logs.

Community
Advanced
swcstudiospaceswcstudiospace

notion

Manage Notion pages, databases, and Workers via the ntn CLI or HTTP API.

Official
Advanced