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

notion-connect

Connects to Notion databases by name to query, create, and manage pages via the Notion API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working with Notion programmatically requires remembering database IDs, looking up schemas, and writing manual API calls. This Skill removes that friction by letting you interact with any Notion database using natural language names, with automatic schema caching and fuzzy name matching. ## Core Features & Use Cases - Database Discovery & Caching: Scans your Notion workspace, discovers all accessible databases, and caches their schemas to a local YAML context file for fast lookups. - Natural Language Queries: Query any database by name with filters (e.g., "query my Projects for active items") using fuzzy matching and disambiguation prompts. - Full CRUD Operations: Create pages with schema-validated properties, update existing pages, manage content blocks, handle comments, and list workspace users. - Use Case: Say "add a new task to my Tasks database" and the Skill loads the cached schema, prompts you for required properties with valid options, and creates the page via the Notion API. ## Quick Start Ask the assistant to connect to Notion and query your Projects database for all active items.

Frequently Asked Questions about notion-connect

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

FAQPage Schema
How do I query a Notion database by name?▼

Run database discovery first to cache schemas, then reference the database by name in natural language. The Skill uses fuzzy matching to resolve names like "Projects" to "Client Projects" and prompts for disambiguation when multiple databases match.

How do I set up Notion API integration?▼

Run the interactive setup wizard script, which guides you through entering your Notion API key, saves configuration to a .env file, captures your user ID, and automatically runs database discovery to build the local context file.

What Notion property types are supported when creating pages?▼

Supported types include title, rich_text, number, select, multi_select, date, checkbox, url, email, phone_number, people, and relation. The Skill validates your input against the cached schema and shows available options for select fields.

Can I filter Notion database queries with multiple conditions?▼

Currently only a single filter per query is supported, such as "Status = Active" or "Tags contains Design". Multiple filters with AND/OR logic are planned for a future release.

Why does the Notion config check fail with exit code 2?▼

Exit code 2 means the integration is not configured, typically because the API key is missing from the .env file. Run the setup wizard script to enter your credentials, then retry the operation.

Does deleting a Notion page remove it permanently?▼

No. The Notion API only archives pages rather than hard-deleting them. Archived pages can be restored from the Notion trash if needed.

Related Skills

Explore More Product & Management Skills→
CrawlScriptCrawlScript
147

notion

Create, read, update, and query Notion pages, databases, and blocks via API.

Official
Intermediate
hmzainjamilhmzainjamil
1

notion-automation

Automate Notion database updates, page creation, and workflow syncs.

Community
Advanced
fivebucksventuresfivebucksventures

content-generator

Automate daily social posts from Notion to Zernio with brand voice.

Official
Advanced
paxtone-iopaxtone-io

posthog

Automate PostHog analytics instrumentation for events, flags, and experiments.

Official
Advanced