Uploads local files to Notion pages as image or file blocks via the Notion API.
npx skills add https://github.com/Dawaad/skills --skill notion-upload-dawaad
Please help me install this Agent Skill. Skill: notion-upload Source: https://github.com/Dawaad/skills/tree/main/skills/notion-upload Command: npx skills add https://github.com/Dawaad/skills --skill notion-upload-dawaad
image blocks; everything else becomes a file block, with manual override via --block-type. - Self-bootstrapping script: PEP 723 inline dependencies let uv run --script install httpx automatically on first run. - Use Case: You have a screenshot at /tmp/chart.png and a Notion page URL. Run the script with the file path and page ID to embed the image inline and get back a download URL, block ID, and expiry time as JSON. ## Quick Start Ask the AI to upload a local file to a Notion page by providing the absolute file path and the Notion page ID or URL, for example: "Upload /tmp/report.pdf to my Notion page 2785bbc0e5c281f48dfae9a48f53f6a6."High-intent search queries and answers about installing and using this skill.
Run the bundled notion_upload.py script with the absolute file path and the Notion page ID. It performs the full flow: creating a file upload, sending the bytes, and attaching an image or file block to the page, then prints a JSON result with the download URL.
Pass the image file path to the script with the default --block-type auto. It detects image MIME types and creates a Notion image block that renders inline; other file types become generic file blocks.
You need a Notion internal integration token set as NOTION_API_TOKEN, created at notion.so/my-integrations. The integration must also be invited to the target page via Share → Add connections, or the attach step returns a 404.
The single-part upload flow supports files up to 20 MB. Larger files are rejected by the script before any API call; compress images or split files to stay under the limit.
A 401 means NOTION_API_TOKEN is missing or invalid. A 404 on the attach step means the integration is not shared with the page; open the page in Notion, click Share, and add the integration as a connection.
corca-aiExport published Notion pages to local Markdown files with source metadata.
ApiliumCodeCreate, read, update, and query Notion pages, databases, and blocks via the API.
vm0-aiManage Notion pages, databases, and blocks via the REST API.
echonoshyUpload local files or external URLs to Notion pages.