@deploybaseline/notion

Notion emulator for local development and tests: the Notion API 2025-09-03 (and 2022-06-28) with pages and property items, databases and data sources, queries with filters and sorts, search, blocks, comments, file uploads, and users, behind integration tokens with capabilities and sharing, OAuth for public integrations, and signed webhooks.

Part of Baseline: local drop-in replacement services for CI and no-network sandboxes.

Usage

npx @deploybaseline/cli start --service notion

Notion starts only when named in config or with --service. In tests, start it from code:

import { createEmulator } from "@deploybaseline/cli";
import { Client } from "@notionhq/client";

const notion = await createEmulator({ service: "notion" });

const client = new Client({ auth: "ntn_baseline_local", baseUrl: notion.url });

await notion.close();

Documentation

• Notion docs: versions, auth, pages, queries, blocks, comments, file uploads, OAuth, webhooks, seed config, and limits
• API reference: http://localhost:3999/docs/notion while the CLI runs (how it works)

License

Apache-2.0