# search

Searches pages, databases, and notes across a Notion workspace via Notion MCP. Helpful when bringing project context directly into the AI agent.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 38
- Author: makenotion
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/makenotion/cursor-notion-plugin/tree/HEAD/skills/search/SKILL.md
- Updated: 2026-02-07
- HTML: https://affpapa.org/en/nevibecode/skills/makenotion-search

## What it 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.

## Requirements
- Works with: Notion

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add makenotion/cursor-notion-plugin --skill search -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/search/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/search/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add makenotion/cursor-notion-plugin --skill search -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/search/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add makenotion/cursor-notion-plugin --skill search -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/search/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install makenotion/cursor-notion-plugin search
```

2. **Manually: put the files in place**
- File: `.github/skills/search/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add makenotion/cursor-notion-plugin --skill search -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/makenotion/cursor-notion-plugin --path skills/search
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/search/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add makenotion/cursor-notion-plugin --skill search -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/makenotion/cursor-notion-plugin/tree/HEAD/skills/search/SKILL.md

## When to use it
- locate project roadmaps and specs in Notion
- find customer feedback databases inside the workspace
- retrieve bug triage lists without leaving the editor

## Example prompts
- 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

## Similar
- [find-skills](https://affpapa.org/en/nevibecode/skills/find-skills.md) — skill · 4000000 installs
- [grill-me](https://affpapa.org/en/nevibecode/skills/grill-me.md) — skill · 1424476 installs
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/handoff.md) — skill · 1038491 installs
- [grilling](https://affpapa.org/en/nevibecode/skills/grilling.md) — skill · 979543 installs
- [teach](https://affpapa.org/en/nevibecode/skills/teach.md) — skill · 862247 installs

## Other versions with the same name
- [search · anthropics](https://affpapa.org/en/nevibecode/skills/anthropics-search.md) — 5000 installs
- [search · browserbase](https://affpapa.org/en/nevibecode/skills/browserbase-search.md) — 2800 installs
- [search · brightdata](https://affpapa.org/en/nevibecode/skills/brightdata-search.md) — 7500 installs
- [search · entireio](https://affpapa.org/en/nevibecode/skills/entireio-search.md) — 458 installs
- [search · mobbin](https://affpapa.org/en/nevibecode/skills/mobbin-search.md) — 342 installs

From the same set: [makenotion/cursor-notion-plugin](https://affpapa.org/en/nevibecode/by/makenotion/cursor-notion-plugin.md) — 13 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md