How do I install the Notion Fetch skill?

Run npx skillmds@latest add tomevault-io/notion-fetch in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Notion Fetch safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Notion Fetch?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Notion Fetch free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Notion Fetch?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Notion Fetch by tomevault-io — Agent Skill

Name: Notion Fetch
Author: tomevault-io

Notion Fetch

Searches Notion workspaces and downloads documents with media files to local folders in raw API format. Use when asked to search Notion, fetch Notion documents, download from Notion, get Notion pages, or export Notion content locally. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

Fetching Notion Documents

Requires NOTION_API_KEY environment variable.

Quick start

Search for documents:

node scripts/notion-cli.js search "query"

Download a document with media:

node scripts/notion-cli.js download <page-id> [output-dir]

Workflow

Copy this checklist when downloading documents:

Download Progress:
- [ ] Search for document
- [ ] Confirm correct document with user
- [ ] Download document and media
- [ ] Verify output files exist

Step 1: Search

node scripts/notion-cli.js search "search terms"

Returns page IDs and titles.

Step 2: Confirm Show results to user and confirm which document to download.

Step 3: Download

node scripts/notion-cli.js download <page-id> ./output-folder

Downloads JSON data and all media files.

Step 4: Verify Check output folder contains:

notion-data.json (raw API response)
notion-data-processed.json (local URLs)
media/ folder with images/videos

Output structure

output-folder/<page-id>/
├── notion-data.json           # Raw Notion API response
├── notion-data-processed.json # URLs rewritten to local paths
├── media-mapping.json         # Original URL → local path mapping
└── media/
    └── [downloaded images and videos]

Use notion-data-processed.json for further processing—URLs point to local ./media/ files.

Reference

For API response format and block types, see reference.md.

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: notion-fetchdescription: Searches Notion workspaces and downloads documents with media files to local folders in raw API format. Use when asked to search Notion, fetch Notion documents, download from Notion, get Notion pages, or export Notion content locally. Use when this capability is needed.---# Fetching Notion DocumentsRequires `NOTION_API_KEY` environment variable.## Quick startSearch for documents:```bashnode scripts/notion-cli.js search "query"```Download a document with media:```bashnode scripts/notion-cli.js download <page-id> [output-dir]```## WorkflowCopy this checklist when downloading documents:```Download Progress:- [ ] Search for document- [ ] Confirm correct document with user- [ ] Download document and media- [ ] Verify output files exist```**Step 1: Search**```bashnode scripts/notion-cli.js search "search terms"```Returns page IDs and titles.**Step 2: Confirm**Show results to user and confirm which document to download.**Step 3: Download**```bashnode scripts/notion-cli.js download <page-id> ./output-folder```Downloads JSON data and all media files.**Step 4: Verify**Check output folder contains:- `notion-data.json` (raw API response)- `notion-data-processed.json` (local URLs)- `media/` folder with images/videos## Output structure```output-folder/<page-id>/├── notion-data.json # Raw Notion API response├── notion-data-processed.json # URLs rewritten to local paths├── media-mapping.json # Original URL → local path mapping└── media/ └── [downloaded images and videos]```Use `notion-data-processed.json` for further processing—URLs point to local `./media/` files.## ReferenceFor API response format and block types, see [reference.md](reference.md).---> Converted and distributed by [TomeVault](https://tomevault.io/claim/biilmann) — claim your Tome and manage your conversions.

Frequently asked questions