notion

Search, read, create, and manage Notion pages and databases via MCP tools.

Updated Dec 18, 2025
One-click install
npx skills add https://github.com/l0lxl0lw/dotfiles --skill notion-l0lxl0lw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/l0lxl0lw/dotfiles/tree/main/ai/shared/skills/integrations/notion
Command: npx skills add https://github.com/l0lxl0lw/dotfiles --skill notion-l0lxl0lw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working with a Notion workspace manually requires switching between apps to search, read, create, and reorganize pages and databases. This Skill lets you perform all of those Notion operations directly through conversation, using the Notion MCP toolset. ## Core Features & Use Cases - Search and Fetch: Find pages, databases, and users across the workspace, then read full page content or database schemas by URL or ID. - Create and Update Content: Create standalone pages, database entries, and new databases with typed property schemas, and update properties or content sections of existing pages. - Organize and Collaborate: Move or duplicate pages, add and retrieve comments, and list teamspaces and workspace members. - Use Case: Ask to create a new entry in your project-tracking database — the Skill fetches the database schema first, matches property names exactly, creates the entry, and returns the Notion URL. ## Quick Start Search my Notion workspace for the product roadmap page and summarize its contents.

Frequently Asked Questions about notion

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

FAQPage Schema
How do I search my Notion workspace from an AI assistant?

Use the notion-search tool with a descriptive query to find pages, databases, or users. Set query_type to "user" for people lookups or "internal" for workspace content, and use one focused query per search call for best results.

How do I create a page in a Notion database?

First fetch the database to get its property schema and data source ID, then call notion-create-pages with property names matching the schema exactly. Always include a title property and use the correct parent type such as database_id or data_source_id.

Can I update only part of a Notion page instead of replacing everything?

Yes. Use replace_content_range to replace a specific section or insert_content_after to add content at a location. For selection_with_ellipsis, provide about 10 characters from the start, an ellipsis, and 10 characters from the end.

Why must I fetch a Notion page before updating it?

Fetching first reveals the current content and structure so updates do not overwrite existing information. For databases, fetching also returns the schema and data source IDs required to create entries correctly.

What property types does a Notion database schema support?

Supported types include title, rich_text, number, select, multi_select, date, people, checkbox, url, email, phone_number, formula, relation, rollup, and status. Date properties use the expanded date:{property}:start format, and checkboxes use __YES__ or __NO__.