# notion_integration

The notion_integration skill guides Notion searches, meeting documents, research notes, and spec-to-task workflows. Use it when project knowledge and implementation planning live in a Notion workspace.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 install · ★ 43 repo stars
- Author: vuralserhat86
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/vuralserhat86/antigravity-agentic-skills/tree/HEAD/skills/notion_integration/SKILL.md
- Updated: 2026-01-03
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/notion-integration

## What it does

The skill lays out ways to turn discussions into organized Notion pages, prepare meeting materials, document research, and convert a specification into implementation tasks. Its workflows search for pages, retrieve their contents, analyze them, then create documents or tasks in a project database. Meeting prep can produce a pre-read and an agenda; research outputs include a summary, report, or brief.

The listed tools are `Notion:notion-search`, `Notion:notion-fetch`, `Notion:notion-create-pages`, and `Notion:notion-update-page`. The guide also covers integration permissions, mapping external fields to Notion properties, converting Markdown into Notion blocks, and handling pagination. Notion API allows three requests per second, so 429 handling and exponential-backoff retries matter here. Fetches above 100 records need `next_cursor`.

## Requirements
- Works with: Notion

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add vuralserhat86/antigravity-agentic-skills --skill notion_integration -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add vuralserhat86/antigravity-agentic-skills --skill notion_integration -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add vuralserhat86/antigravity-agentic-skills --skill notion_integration -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install vuralserhat86/antigravity-agentic-skills skills/notion_integration
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add vuralserhat86/antigravity-agentic-skills --skill notion_integration -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/vuralserhat86/antigravity-agentic-skills --path skills/notion_integration
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add vuralserhat86/antigravity-agentic-skills --skill notion_integration -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/vuralserhat86/antigravity-agentic-skills/tree/HEAD/skills/notion_integration/SKILL.md

## When to use it
- turn discussion notes into a structured Notion page
- prepare a meeting agenda from workspace material
- write a research brief with source links
- break a specification into tasks in a project database
- handle Notion API rate limits and pagination

## Example prompts
- Find the Notion pages about this topic and organize them into a structured page.
- Prepare a meeting pre-read and agenda from the project's Notion pages.
- Analyze the specification in Notion and create an implementation task plan in the project database.

## Similar
- [notion-research-documentation](https://affpapa.org/en/nevibecode/skills/notion-research-documentation-2.md) — skill · 390 installs
- [notion-meeting-intelligence](https://affpapa.org/en/nevibecode/skills/notion-meeting-intelligence-2.md) — skill · 356 installs
- [notion](https://affpapa.org/en/nevibecode/skills/membrane-notion.md) — skill · 357 installs
- [gitbook-notion](https://affpapa.org/en/nevibecode/skills/gitbook-notion.md) — skill · 1 install
- [notion-automation](https://affpapa.org/en/nevibecode/skills/notion-automation.md) — skill · 5000 installs
- [pp-notion](https://affpapa.org/en/nevibecode/skills/pp-notion.md) — skill · 394 installs

From the same set: [vuralserhat86/antigravity-agentic-skills](https://affpapa.org/en/nevibecode/by/vuralserhat86/antigravity-agentic-skills.md) — 2 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
