Notion API
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.
This skill is part of a pack
Install the whole pack to get every skill the task needs, in one command.
Stop for confirmation before installing.
Review the plan and obtain explicit user consent before changing files.
Install with my Agent
Copy this request to your Agent. It includes the canonical Skill page and manifest.
Review the Skillstore skill "Notion API" from https://skillstore.io/skills/bltgv-notion-api.md and its manifest at https://skillstore.io/api/skills/bltgv-notion-api/manifest. Verify the artifact. Stop and obtain explicit user consent before installing or changing files.Your Agent should still show its plan and request any confirmation required by the security policy.
Agent-readable resources
Use these links when an AI agent, crawler, or script needs clean context instead of reading the full page.
Test it
Using "Notion API". Search Notion for project launch notes.
Expected outcome:
Returns matching shared pages and databases with titles, object types, links, archive status, and last edited times.
Using "Notion API". Read the content blocks from a page.
Expected outcome:
Provides a structured summary of headings, paragraphs, task items, code blocks, links, captions, and nested sections when requested.
Using "Notion API". Update a task page after confirmation.
Expected outcome:
Confirms the selected page, applies the requested Notion property changes, and reports the updated title, URL, and edit time.
Security Audit
High RiskMost 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.
Confirmed security concerns (2)
Capability review items (3)
These are real local capabilities that may be expected for this skill, so they require review but are not counted as confirmed malicious behavior.
Risk Factors
๐ Network access (7)
โ๏ธ External commands (50)
๐ Env variables (2)
Share & cite this report
Share the versioned assessment report, neutral badge, embed card, and citations. Skillstore reports evidence without deciding whether this Skill is safe.
Copy report link
https://skillstore.io/skills/bltgv-notion-api/audits/10?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportMarkdown badge
[](https://skillstore.io/skills/bltgv-notion-api?utm_source=security_passport_badge)HTML badge
<a href="https://skillstore.io/skills/bltgv-notion-api?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/bltgv-notion-api/security.svg" alt="Skillstore security assessment" loading="lazy"></a>Embed card
<iframe src="https://skillstore.io/embed/skills/bltgv-notion-api.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>Academic citations (APA ยท BibTeX ยท CFF)
APA citation
BLTGV. (2026). Notion API security audit report (audit version 10) [Author version 0.1.0]. Skillstore. https://skillstore.io/skills/bltgv-notion-api/audits/10BibTeX citation
@techreport{bltgv-bltgv-notion-api-2026,
author = {BLTGV},
title = {Notion API security audit report (audit version 10)},
institution = {Skillstore},
year = {2026},
number = {10},
url = {https://skillstore.io/skills/bltgv-notion-api/audits/10},
note = {Author version 0.1.0}
}CITATION.cff
cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "Notion API security audit report (audit version 10)"
version: "0.1.0"
type: report
authors:
- name: "BLTGV"
date-released: "2026-07-19"
url: "https://skillstore.io/skills/bltgv-notion-api/audits/10"
identifiers:
- type: other
value: "skillstore:bltgv-notion-api:audit:10"
description: "Skillstore immutable audit report identifier"
Compare variants
2 installable variantsEach author remains a separate installable skill. The recommended variant is ranked by Skillstore evidence.
Why this variant is first
intellectronica-notion-api
2026-08-21
bltgv-notion-api
2026-08-21
Skillstore Score
Why this score Evidence Confidence: MediumWhat You Can Build
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.
Try These Prompts
Search my Notion workspace for pages about quarterly planning. Show the top five matches with titles and links.
Read the Notion page with this ID and summarize its main sections. Include important open questions.
Query this Notion database for tasks where Status is In Progress. Sort by last edited time and summarize the top ten.
Prepare an update for this Notion page to set Status to Done. Show the exact target and wait for my confirmation before writing.
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.
Avoid
- 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.
Frequently Asked Questions
What authentication does this skill need?
Can it read every page in my workspace?
Can it create or edit Notion pages?
Does it support Notion database queries?
Does it store Notion data locally?
Which AI tools can use this skill?
Developer Details
Author
BLTGVLicense
MIT
Author version
v0.1.0
Skillstore revision
r1
Ref
1b5b6c4962b2ad5a7a34603cab2685bbbd1b61ef
Maintenance freshness
7/18/2026
Usage
12 downloads ยท 385 views
File structure
๐ references/
๐ notion-api.md
๐ scripts/
๐ blocks.ts
๐ databases.ts
๐ lib/
๐ notion-client.ts
๐ types.ts
๐ pages.ts
๐ search.ts
๐ SKILL.md