search · makenotion — Claude Code skill: what it does, how to install
Searches pages, databases, and notes across a Notion workspace via Notion MCP. Helpful when bringing project context directly into the AI agent.
npx skills add makenotion/cursor-notion-plugin --skill search -a claude-codeWhat search does
This skill guides the AI assistant in running natural-language queries against Notion. Instead of constructing raw API calls, you ask for roadmaps, customer notes, or bug queues. The agent routes the request through the Notion MCP server, querying databases or workspace records.
Output arrives as a clean list containing document titles, entry types, brief summaries, and direct Notion links. The prompt explicitly blocks raw JSON dumps. When a query yields nothing, the agent suggests better phrasing.
The skill fails immediately if the Notion MCP server is not configured in your environment.
What it helps with
- locate project roadmaps and specs in Notion
- find customer feedback databases inside the workspace
- retrieve bug triage lists without leaving the editor
Example prompts for the agent
- Find the Q1 roadmap page in our Notion workspace
- Search Notion for customer feedback on the latest release
- Look up our Notion database for bugs triage
How to install search
1Skills CLI (Vercel)
npx skills add makenotion/cursor-notion-plugin --skill search -a claude-code2Manually: put the files in place
~/.claude/skills/search/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/search/
1Skills CLI (Vercel)
npx skills add makenotion/cursor-notion-plugin --skill search -a codex2Manually: put the files in place
.agents/skills/search/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add makenotion/cursor-notion-plugin --skill search -a cursor2Manually: put the files in place
.cursor/skills/search/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install makenotion/cursor-notion-plugin search2Manually: put the files in place
.github/skills/search/SKILL.md1Skills CLI (Vercel)
npx skills add makenotion/cursor-notion-plugin --skill search -a gemini-cli2Platform CLI
gemini skills install https://github.com/makenotion/cursor-notion-plugin --path skills/searchManually: put the files in place
.devin/skills/search/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add makenotion/cursor-notion-plugin --skill search -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 search
How to install search in Claude Code?
Run npx skills add makenotion/cursor-notion-plugin --skill search -a claude-code in your terminal. This command saves the skill definition at ~/.claude/skills/search/SKILL.md.
What does the search skill do?
It directs the assistant to query your Notion workspace through the Notion MCP server and present readable results with Notion links.
Does this skill require Notion MCP?
Yes, it depends on an active Notion MCP server connection to reach your workspace records.
Similar skills
All skills for Notes, tasks and projects →search by other authors comes first.