notion-delete

Archives Notion pages via the Notion API using page IDs or URLs.

366|90|Updated Aug 22, 2026
One-click install
npx skills add https://github.com/bam-bam-2/solo-skills --skill notion-delete-bam-bam-2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion-delete
Source: https://github.com/bam-bam-2/solo-skills/tree/main/skills/notion-delete
Command: npx skills add https://github.com/bam-bam-2/solo-skills --skill notion-delete-bam-bam-2

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Notion MCP integrations lack a delete tool, so removing pages programmatically requires calling the Notion API directly. This Skill archives one or more Notion pages (moving them to the trash) from a page ID or URL without manual clicking. ## Core Features & Use Cases - Direct API Archiving: Sends a PATCH request to the Notion API setting archived: true, moving pages to the Notion trash (recoverable within 30 days). - Flexible Input: Accepts raw page IDs, hyphenated IDs, or full Notion URLs, and processes multiple pages in a single command. - Automatic Token Discovery: Searches for NOTION_TOKEN in environment variables and several local .env file locations. - Use Case: You want to clean up empty draft pages in a content database. Provide the page URLs and the script archives them all at once, printing each deleted page title. ## Quick Start Ask the agent to delete a Notion page by saying "delete this Notion page" followed by the page URL or ID.

Frequently Asked Questions about notion-delete

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I delete a Notion page with the Notion API?

Send a PATCH request to https://api.notion.com/v1/pages/{page_id} with the JSON body {"archived": true} and a Bearer integration token. This moves the page to the Notion trash rather than permanently deleting it.

How to delete multiple Notion pages at once?

Pass multiple page IDs or URLs as separate arguments to the script, and it archives each one sequentially in a single run. Each page reports success or failure with its title or error message.

Does deleting a Notion page via API permanently remove it?

No, API deletion archives the page, moving it to the Notion trash where it can be restored within 30 days. Permanent removal requires emptying the trash manually in the Notion app.

Why does Notion API page deletion return an error?

Errors typically occur when the integration token lacks access to the page or its parent database, or when the page ID is invalid. Share the target page or database with your integration in Notion and verify the token is correct.

Where does the script look for the Notion API token?

It first checks the NOTION_TOKEN environment variable, then searches specific .env files under ~/Projects/getback paths and finally ~/.env. You can set the variable directly to override file-based lookup.