notion-mcp — Claude Code skill: what it does, how to install
Connects Notion to your AI coding agent. The skill lets your agent search workspace pages, inspect databases, and append findings directly from the CLI.
npx skills add Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI --skill notion-mcp -a claude-codeWhat notion-mcp does
This skill brings Notion into your terminal agent. The model reads pages and databases to retrieve project context or document findings.
It is structured as a master-skill with version 4.1.0-fractal. The logic relies on five sub-skills: search, retrieve_block_children, retrieve_database, query_database, and append_block_children. Without these sub-modules in place, the agent cannot query your Notion databases.
What it helps with
- search for pages and notes across a Notion workspace
- inspect child blocks of a page using
retrieve_block_children - fetch database schema and query its records
- append new content blocks to document findings
Example prompts for the agent
- Search Notion for the project architecture page using notion-mcp
- Run query_database on our Notion tasks database and list open issues
- Append the refactoring summary to the bottom of the page using append_block_children
How to install notion-mcp
1Skills CLI (Vercel)
npx skills add Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI --skill notion-mcp -a claude-code2Manually: put the files in place
~/.claude/skills/notion-mcp/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/notion-mcp/
1Skills CLI (Vercel)
npx skills add Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI --skill notion-mcp -a codex2Manually: put the files in place
.agents/skills/notion-mcp/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI --skill notion-mcp -a cursor2Manually: put the files in place
.cursor/skills/notion-mcp/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI notion-mcp2Manually: put the files in place
.github/skills/notion-mcp/SKILL.md1Skills CLI (Vercel)
npx skills add Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI --skill notion-mcp -a gemini-cli2Platform CLI
gemini skills install https://github.com/Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI --path .agent/skills/notion-mcpManually: put the files in place
.devin/skills/notion-mcp/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI --skill notion-mcp -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about notion-mcp
How do I install notion-mcp in Claude Code?
Run npx skills add Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI --skill notion-mcp -a claude-code. This installs the skill directly into your Claude Code environment.
What does notion-mcp do?
It enables your coding agent to interact with Notion workspaces by searching pages, querying databases, and appending new blocks.
Which sub-skills are included in notion-mcp?
The skill includes five sub-skills: search, retrieve_block_children, retrieve_database, query_database, and append_block_children.
Source text
SKILL.md · MIT
--- name: notion-mcp description: Official Notion Model Context Protocol Server for workspace interaction. category: tools version: 4.1.0-fractal layer: master-skill --- # Notion MCP Skill ## 🎯 Goal Enable the AI Agent to interact with Notion workspaces (Pages, Databases, Comments) to retrieve context or document findings. ## 🛠️ Tools ## 🧠 Knowledge Modules (Fractal Skills) ### 1. [`search`](./sub-skills/search.md) ### 2. [`retrieve_block_children`](./sub-skills/retrieve_block_children.md) ### 3. [`retrieve_database`](./sub-skills/retrieve_database.md) ### 4. [`query_database`](./sub-skills/query_database.md) ### 5. [`append_block_children`](./sub-skills/append_block_children.md)
© Dokhacgiakhoa · MIT · Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI
