Agent skill · ma08
Notion
Notion workspace integration. Use when user wants to read/write Notion pages, search databases, create tasks, or sync content with Notion.
What it needs
About 2k tokens when loaded.
What this skill does
Notion Skill Integrate with Notion workspaces to read and write content. When to Use User wants to read or search Notion pages User wants to create or update pages User wants to query databases User wants to sync content to/from Notion User wants to create tasks or notes in Notion User asks about their Notion workspace Critical Gotchas (SDK v5.6.0) 1. The databases.query() method DOES NOT EXIST in this SDK version. Use notion.search() instead. 2. The databases.retrieve() method returns only basic metadata (title, url, timestamps). The properties field is undefined. 3. Always write scripts to files. Never use inline node -e evaluation because shell metacharacters cause errors. 4. Pages must be shared with your integration or you get objectnotfound errors. Setup Requirements Environment variables (assumed already available due to the start session hook): NOTIONAPIKEY: Your integration token (starts with ntn) NOTIONDATABASEID or NOTIONUPDATESDBID: Optional database ID Node packages required: @notionhq/client (official SDK) Install with: npm install @notionhq/client Example Scripts All examples are in the examples/ subdirectory. Run from the skill directory. Search pages: node examples/search-pages.js node examples/search-pages.js "query text" Read page content: node examples/read-page.js PAGEID Create a page: node examples/create-page.js DATABASEID "Page Title" Append content to page: node examples/append-content.js PAGEID "Content text" Test connection: node examples/test-connection.js SDK Methods Available Search (primary query method): notion.search(params) - Search pages and databases Pages: notion.pages.retrieve(params) - Get page metadata notion.pages.create(params) - Create new page notion.pages.update(params) - Update page properties Blocks: notion.blocks.children.list(params) - Read page content notion.blocks.children.append(params) - Add content to page notion.blocks.retrieve(params) - Get single block notion.blocks.update(params) - Update a block notion.bloc …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills ma08/notion