Notion Local Dev Loop

Overview

Set up a fast, reproducible local development workflow for Notion integrations. This skill covers creating a dedicated dev integration with its own token, structuring the project for testability, mocking the Notion SDK in unit tests, and running integration tests against a sandboxed dev workspace. The approach keeps production data safe while enabling rapid iteration.

Prerequisites

• Completed notion-install-auth setup (you have a working Notion integration)
• Node.js 18+ with npm/pnpm, or Python 3.10+
• A Notion workspace where you can create test pages and databases

Instructions

Step 1: Create a Dev Integration and Workspace Sandbox

Create a separate integration exclusively for development. This prevents accidental writes to production data.