# Manage Notion Pages and Databases

Teams need fast access to trusted Notion workspace content from their assistant. This skill lets Claude, Codex, and Claude Code search, read, create, and update shared Notion content.

## Install

```bash
npx skillstore add bltgv/notion-api
```

## Metadata

- Status: approved
- Slug: bltgv-notion-api
- Version: 0.1.0
- Author version: 0.1.0
- Skillstore revision: r1
- Version status: valid
- Tree hash: 4e55b75bafa13b558340a34253564a8c6bbe909af87eb2eac391519deab90288
- Author: BLTGV
- GitHub username: BLTGV
- License: MIT
- Repository: https://github.com/BLTGV/agent-skills/tree/master/skills/notion
- Ref: 1b5b6c4962b2ad5a7a34603cab2685bbbd1b61ef
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: network, external\_commands, env\_access
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/bltgv-notion-api
- Manifest: https://skillstore.pages.dev/api/skills/bltgv-notion-api/manifest

## Capabilities

- Search shared Notion pages and databases with optional text and object filters.
- Retrieve page metadata, parent information, properties, icons, covers, and URLs.
- Create new pages under a page or database with titles, icons, and properties.
- Update page titles, icons, archive state, and database page properties.
- Query databases with Notion filters, sorts, and result limits.
- List page or block children, including optional recursive block traversal.

## Use Cases

- Find Workspace Knowledge: Search shared Notion pages and databases, then summarize the most relevant results for a question.
- Update Project Records: Query a project database and update selected task properties after confirmation.
- Draft New Notion Pages: Create meeting notes, briefs, or database entries inside an approved parent page or database.

## Prompt Templates

### Search Notion

```
Search my Notion workspace for pages about quarterly planning. Show the top five matches with titles and links.
```

### Read Page Content

```
Read the Notion page with this ID and summarize its main sections. Include important open questions.
```

### Query a Database

```
Query this Notion database for tasks where Status is In Progress. Sort by last edited time and summarize the top ten.
```

### Update After Review

```
Prepare an update for this Notion page to set Status to Done. Show the exact target and wait for my confirmation before writing.
```

## Limitations

- Requires a NOTION\_TOKEN environment variable from a Notion integration.
- Can access only pages and databases shared with that integration.
- Depends on the Notion API and its rate limits.
- Does not create or edit database schemas.

## Best Practices

- Use a dedicated Notion integration with the smallest required page access.
- Confirm all create, update, and archive actions before running write commands.
- Start with narrow search terms and small result limits before broad workspace searches.

## Anti Patterns

- Do not share entire workspaces with the integration when one page is enough.
- Do not paste Notion tokens into prompts or page content.
- Do not run archive or property updates without checking the target page first.

## Security Audit

- Audited at: 2026-07-19T02:30:02.038\+00:00
- Summary: Most static alerts are false positives caused by Markdown backticks, TypeScript template literals, CLI examples, and ordinary API documentation. The skill genuinely reads NOTION\_TOKEN and sends authenticated requests to the fixed Notion API. Semantic review also found missing trust guidance for retrieved content and no explicit confirmation requirement before page mutations.

## Stats

- Views: 385
- Downloads: 17
- Favorites: 0
- Popularity score: 0