notion-skill_skill

Overview

This skill reads and queries Notion databases and pages across multiple workspaces. It is built for exporting data, previewing database structure, searching content, and migrating Notion content to other systems like Obsidian. Setup requires creating an internal integration and sharing pages with that integration.

How this skill works

The skill uses Notion internal integration tokens to list workspaces, enumerate databases, query database entries, fetch individual pages, and export databases to JSON. It outputs machine-readable JSON for all commands and supports pagination, simple property filters, and selecting the account/workspace to use. Tokens are stored locally in a config file and each workspace needs its own integration.

When to use it

• You need to export a Notion database for migration or backup.
• You want to preview database entries or schema before transforming data.
• You need to list all databases accessible to a given integration.
• You want to fetch a page’s properties and content programmatically.
• You need to search Notion content by text, type, or workspace.

Best practices

• Create one internal integration per Notion workspace and grant only the "Read content" capability.
• Share every database or page you want the skill to access with the integration explicitly.
• Store tokens in the local config file and keep that file out of source control (it is ignored).
• Preview with a small --limit first before exporting large datasets to confirm structure.
• Revoke integration tokens from the Notion Integrations dashboard if a token is compromised.

Example use cases

• List accessible databases in a workspace to discover dataset IDs before migration.
• Query a database with a property filter to extract active tasks or records.
• Export a full database to JSON for import into Obsidian or another note system.
• Fetch a single page to retrieve its properties and content for automated reporting.
• Search across pages and databases to locate references or gather content for audits.