@lpenguin/notion-cli 1.0.0

package/README.md

@@ -0,0 +1,245 @@
+# notion-cli
+
+CLI tool for reading and editing Notion entries through Markdown and CSV. AI agent friendly.
+
+## Installation
+
+```bash
+# Run directly with npx
+npx notion-cli page read <page-id>
+
+# Or install globally
+npm install -g notion-cli
+notion-cli page read <page-id>
+```
+
+## Configuration
+
+Set your Notion Integration Token:
+
+```bash
+export NOTION_TOKEN=ntn_xxx
+
+# Or pass directly
+notion-cli --token ntn_xxx page read <page-id>
+```
+
+You can also create a `~/.notion-cli.json` config file:
+
+```json
+{
+  "token": "ntn_xxx"
+}
+```
+
+## Global Options
+
+| Flag | Description |
+|------|-------------|
+| `--token <token>` | Notion API integration token (overrides env/config) |
+| `--json` | Structured JSON output for machine consumption |
+| `--dry-run` | Preview changes without executing writes |
+| `-v, --verbose` | Enable debug output to stderr |
+| `--no-color` | Disable colored output |
+
+## Commands
+
+### `page read` — Read a Notion Page as Markdown
+
+Fetch a Notion page and output its content as Markdown. This command is idempotent and read-only.
+
+```bash
+notion-cli page read <page-id>
+```
+
+**Examples:**
+
+```bash
+# Read page content
+notion-cli page read abc123def456
+
+# Read as JSON (for scripting)
+notion-cli page read abc123def456 --json
+```
+
+When `--json` is enabled, the output includes `pageId`, `title`, and `markdown` fields. Status messages are always written to stderr, and the markdown content goes to stdout, so you can pipe it safely: `notion-cli page read <id> > page.md`.
+
+---
+
+### `page create` — Create a New Page
+
+Create a new Notion page from Markdown content.
+
+```bash
+notion-cli page create --parent <page-id> --file content.md
+notion-cli page create --parent <page-id> --title "My Page" --content "# Hello"
+notion-cli page create --parent <db-id> --db --file entry.md
+```
+
+| Option | Description |
+|--------|-------------|
+| `--parent <id>` | **Required.** Parent page or database ID |
+| `-f, --file <path>` | Path to Markdown file |
+| `--content <markdown>` | Inline Markdown content |
+| `--title <title>` | Page title (overrides H1 in content) |
+| `--db` | Create as a database entry instead of a sub-page |
+
+---
+
+### `page write` — Replace Page Content
+
+Replace a Notion page's content with new Markdown content. This is a destructive operation that replaces ALL existing content on the page.
+
+```bash
+notion-cli page write <page-id> --file content.md
+notion-cli page write <page-id> --content "# New Content"
+cat content.md | notion-cli page write <page-id>
+```
+
+| Option | Description |
+|--------|-------------|
+| `-f, --file <path>` | Path to Markdown file |
+| `--content <markdown>` | Inline Markdown content |
+
+**Image Upload Support:**
+
+When using `page write`, images with `file://` URLs will be automatically uploaded to Notion's file storage:
+
+```markdown
+# My Page
+
+![Local Image](file:///path/to/image.png)
+![External Image](https://example.com/image.jpg)
+```
+
+- Local images with `file://` URLs are uploaded to Notion
+- External URLs (http/https) remain as external references
+- Supports common formats: PNG, JPG, GIF, WebP, SVG, BMP, TIFF
+- Works with both Unix and Windows paths
+- Handles URL-encoded paths with special characters
+
+**Examples:**
+
+```bash
+# Replace page content from file
+notion-cli page write abc123def456 --file mypage.md
+
+# Replace with inline content
+notion-cli page write abc123def456 --content "# Hello\n\nNew content"
+
+# Replace from stdin
+echo "# Updated\n\nNew content" | notion-cli page write abc123def456
+
+# Dry run to preview changes
+notion-cli page write abc123def456 --file mypage.md --dry-run
+```
+
+> ⚠️ **Warning:** This command replaces ALL existing content. For partial edits, use `page patch` instead.
+
+---
+
+### `page list` — List Pages
+
+List or search Notion pages accessible to the integration.
+
+```bash
+notion-cli page list
+notion-cli page list --query "search term" --limit 20
+notion-cli page list --cursor <cursor>
+```
+
+---
+
+### Databases
+
+Query, export, import, and inspect Notion databases.
+
+#### `db list` — List databases
+
+List accessible Notion databases.
+
+```bash
+notion-cli db list
+notion-cli db list --query "Projects" --limit 10
+```
+
+#### `db query` — Query Database
+
+Query a Notion database. Outputs CSV by default, JSON with `--json`.
+
+```bash
+notion-cli db query <database-id>
+notion-cli db query <database-id> --filter '{"property":"Status","select":{"equals":"Done"}}'
+```
+
+#### `db export` — Export to CSV
+
+Export full Notion database to CSV.
+
+```bash
+notion-cli db export <database-id> --out data.csv
+```
+
+#### `db import` — Import from CSV
+
+Import CSV rows into a Notion database.
+
+```bash
+notion-cli db import <database-id> --file data.csv
+notion-cli db import <database-id> --file data.csv --sync
+```
+
+| Option | Description |
+|--------|-------------|
+| `-f, --file <path>` | **Required.** Path to CSV file |
+| `--sync` | **Synchronize mode.** Pages in Notion that are NOT in the CSV will be **archived** (sent to Trash). |
+
+> ⚠️ **Warning on --sync:** This mode is destructive. It ensures the database in Notion exactly matches your CSV. If a row exists in Notion but its `_notion_id` is missing from your CSV, it will be deleted from the database.
+
+#### `db create` — Create Database
+
+Create a new Notion database in a parent page.
+
+```bash
+notion-cli db create --parent <page-id> --title "My Database"
+notion-cli db create --parent <page-id> --title "Tasks" --schema '{"Status": {"select": {}}}'
+```
+
+| Option | Description |
+|--------|-------------|
+| `-p, --parent <id>` | **Required.** Parent page ID |
+| `-t, --title <text>`| **Required.** Database title |
+| `-s, --schema <json>`| Database schema (Notion properties JSON) |
+
+#### `db schema` — Show Schema
+
+Show database property schema.
+
+```bash
+notion-cli db schema <database-id>
+```
+
+---
+
+### Search
+
+```bash
+notion-cli search "query"
+notion-cli search "query" --type page
+notion-cli search "query" --type database
+```
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | Success |
+| `1` | General error |
+| `2` | Validation error (bad arguments) |
+| `3` | Authentication error |
+| `4` | Not found |
+| `5` | Rate limited |
+
+## License
+
+MIT

package/dist/commands/database/create.d.ts

@@ -0,0 +1,8 @@
+/**
+ * notion-cli db create
+ *
+ * Create a new Notion database in a parent page.
+ */
+import { type Command } from 'commander';
+export declare function registerDbCreateCommand(db: Command): void;
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/database/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/database/create.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAiEzD"}

package/dist/commands/database/create.js

@@ -0,0 +1,71 @@
+/**
+ * notion-cli db create
+ *
+ * Create a new Notion database in a parent page.
+ */
+import {} from 'commander';
+import { getClient } from '../../lib/client.js';
+import { printSuccess, printError, isJsonMode } from '../../lib/output.js';
+import { withRateLimit } from '../../lib/rate-limit.js';
+import { parseNotionId } from '../../utils/id.js';
+import {} from '../../lib/types.js';
+import { toCliError } from '../../lib/errors.js';
+import * as logger from '../../utils/logger.js';
+export function registerDbCreateCommand(db) {
+    db.command('create')
+        .description('Create a new database.')
+        .requiredOption('-p, --parent <id>', 'Parent page ID')
+        .requiredOption('-t, --title <text>', 'Database title')
+        .option('-s, --schema <json>', 'Database schema (Notion properties JSON)', '{"Name": {"title": {}}}')
+        .action(async (cmdOpts) => {
+        try {
+            const opts = db.optsWithGlobals();
+            const parentId = parseNotionId(cmdOpts.parent);
+            const client = getClient(opts.token);
+            let properties;
+            try {
+                properties = JSON.parse(cmdOpts.schema);
+            }
+            catch (err) {
+                throw new Error(`Invalid schema JSON: ${err.message}`);
+            }
+            if (opts.dryRun === true) {
+                logger.info(`[Dry Run] Would create database "${cmdOpts.title}" in page ${parentId}`);
+                if (isJsonMode()) {
+                    printSuccess({ dryRun: true, parentId, title: cmdOpts.title, properties });
+                }
+                return;
+            }
+            const response = (await withRateLimit(() => client.databases.create({
+                parent: {
+                    type: 'page_id',
+                    page_id: parentId,
+                },
+                title: [
+                    {
+                        type: 'text',
+                        text: {
+                            content: cmdOpts.title,
+                        },
+                    },
+                ],
+                initial_data_source: {
+                    properties: properties,
+                },
+            }), 'databases.create'));
+            if (isJsonMode()) {
+                printSuccess(response);
+            }
+            else {
+                logger.info(`Database created successfully: ${response.id}`);
+                process.stdout.write(`URL: ${response.url}\n`);
+            }
+        }
+        catch (err) {
+            const cliErr = toCliError(err);
+            printError(cliErr.code, cliErr.message);
+            process.exitCode = cliErr.exitCode;
+        }
+    });
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/database/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/commands/database/create.ts"],"names":[],"mappings":"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"}

package/dist/commands/database/delete.d.ts

@@ -0,0 +1,10 @@
+/**
+ * notion-cli db delete <db-id> --ids <id1,id2,...>
+ *
+ * Archive (soft-delete) pages in a Notion database by their page IDs.
+ *
+ * This command is NOT idempotent (archives pages each run).
+ */
+import { type Command } from 'commander';
+export declare function registerDbDeleteCommand(db: Command): void;
+//# sourceMappingURL=delete.d.ts.map

package/dist/commands/database/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/commands/database/delete.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAkFzD"}

package/dist/commands/database/delete.js

@@ -0,0 +1,83 @@
+/**
+ * notion-cli db delete <db-id> --ids <id1,id2,...>
+ *
+ * Archive (soft-delete) pages in a Notion database by their page IDs.
+ *
+ * This command is NOT idempotent (archives pages each run).
+ */
+import {} from 'commander';
+import { getClient, resolveDataSourceId } from '../../lib/client.js';
+import { printSuccess, printError, isJsonMode } from '../../lib/output.js';
+import { isDryRun } from '../../lib/safety.js';
+import { withRateLimit } from '../../lib/rate-limit.js';
+import { parseNotionId } from '../../utils/id.js';
+import {} from '../../lib/types.js';
+import { toCliError, ValidationError } from '../../lib/errors.js';
+import * as logger from '../../utils/logger.js';
+export function registerDbDeleteCommand(db) {
+    db.command('delete')
+        .description('Archive (delete) pages from a Notion database by page IDs.')
+        .argument('<db-id>', 'Notion database ID or URL')
+        .requiredOption('--ids <ids>', 'Comma-separated list of page IDs or URLs to archive')
+        .action(async (rawId, cmdOpts) => {
+        try {
+            const opts = db.optsWithGlobals();
+            const rawIdParsed = parseNotionId(rawId);
+            const client = getClient(opts.token);
+            const dbId = await resolveDataSourceId(client, rawIdParsed);
+            const pageIds = cmdOpts.ids
+                .split(',')
+                .map((id) => id.trim())
+                .filter((id) => id.length > 0)
+                .map(parseNotionId);
+            if (pageIds.length === 0) {
+                throw new ValidationError('No page IDs provided. Use --ids <id1,id2,...>.');
+            }
+            logger.info(`Delete: ${String(pageIds.length)} pages to archive.`);
+            if (isDryRun(opts.dryRun)) {
+                if (isJsonMode()) {
+                    printSuccess({
+                        databaseId: dbId,
+                        toArchive: pageIds.length,
+                        pageIds,
+                        dryRun: true,
+                    });
+                }
+                else {
+                    logger.info(`Dry run: Would archive ${String(pageIds.length)} pages from database ${dbId}.`);
+                }
+                return;
+            }
+            let archived = 0;
+            let failed = 0;
+            await Promise.all(pageIds.map(async (pageId) => {
+                try {
+                    await withRateLimit(() => client.pages.update({ page_id: pageId, archived: true }), 'pages.update (archive)');
+                    archived++;
+                }
+                catch (err) {
+                    failed++;
+                    logger.warn(`Failed to archive page ${pageId}: ${String(err)}`);
+                }
+            }));
+            const result = {
+                databaseId: dbId,
+                archived,
+                failed,
+                total: pageIds.length,
+            };
+            if (isJsonMode()) {
+                printSuccess(result);
+            }
+            else {
+                logger.success(`Delete complete: ${String(archived)} archived, ${String(failed)} failed.`);
+            }
+        }
+        catch (err) {
+            const cliErr = toCliError(err);
+            printError(cliErr.code, cliErr.message);
+            process.exitCode = cliErr.exitCode;
+        }
+    });
+}
+//# sourceMappingURL=delete.js.map

package/dist/commands/database/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/commands/database/delete.ts"],"names":[],"mappings":"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"}

package/dist/commands/database/export.d.ts

@@ -0,0 +1,11 @@
+/**
+ * notion-cli db export <db-id> --out <file.csv>
+ *
+ * Export an entire Notion database to a CSV file.
+ * Fetches all pages with pagination and writes to file or stdout.
+ *
+ * This command is idempotent and read-only.
+ */
+import { type Command } from 'commander';
+export declare function registerDbExportCommand(db: Command): void;
+//# sourceMappingURL=export.d.ts.map

package/dist/commands/database/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/commands/database/export.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAYzC,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAoEzD"}

package/dist/commands/database/export.js

@@ -0,0 +1,74 @@
+/**
+ * notion-cli db export <db-id> --out <file.csv>
+ *
+ * Export an entire Notion database to a CSV file.
+ * Fetches all pages with pagination and writes to file or stdout.
+ *
+ * This command is idempotent and read-only.
+ */
+import {} from 'commander';
+import { writeFileSync } from 'node:fs';
+import { getClient, resolveDataSourceId } from '../../lib/client.js';
+import { rowsToCsv } from '../../lib/csv.js';
+import { printSuccess, printError } from '../../lib/output.js';
+import { withRateLimit } from '../../lib/rate-limit.js';
+import { parseNotionId } from '../../utils/id.js';
+import {} from '../../lib/types.js';
+import { toCliError } from '../../lib/errors.js';
+import * as logger from '../../utils/logger.js';
+export function registerDbExportCommand(db) {
+    db.command('export')
+        .description('Export full Notion database to CSV.')
+        .argument('<db-id>', 'Notion database ID or URL')
+        .option('-o, --out <file>', 'Output CSV file path (stdout if omitted)')
+        .action(async (rawId, cmdOpts) => {
+        try {
+            const opts = db.optsWithGlobals();
+            const rawIdParsed = parseNotionId(rawId);
+            const client = getClient(opts.token);
+            // Resolve db ID to data source ID
+            const dbId = await resolveDataSourceId(client, rawIdParsed);
+            // Fetch all rows with pagination
+            const allResults = [];
+            let cursor;
+            let hasMore = true;
+            while (hasMore) {
+                const response = await withRateLimit(() => client.dataSources.query({
+                    data_source_id: dbId,
+                    page_size: 100,
+                    start_cursor: cursor,
+                }), 'dataSources.query');
+                allResults.push(...response.results);
+                hasMore = response.has_more;
+                cursor = response.next_cursor ?? undefined;
+                logger.debug(`Fetched ${String(allResults.length)} rows so far...`);
+            }
+            // Extract property names
+            const propertyNames = allResults.length > 0
+                ? Object.keys(allResults[0]?.['properties'] ?? {})
+                : [];
+            // Generate CSV
+            const csv = rowsToCsv(allResults, propertyNames);
+            // Write output
+            if (cmdOpts.out !== undefined) {
+                writeFileSync(cmdOpts.out, csv, 'utf-8');
+                printSuccess({
+                    databaseId: dbId,
+                    file: cmdOpts.out,
+                    rowCount: allResults.length,
+                    columns: propertyNames,
+                });
+                logger.success(`Exported ${String(allResults.length)} rows to ${cmdOpts.out}`);
+            }
+            else {
+                process.stdout.write(csv);
+            }
+        }
+        catch (err) {
+            const cliErr = toCliError(err);
+            printError(cliErr.code, cliErr.message);
+            process.exitCode = cliErr.exitCode;
+        }
+    });
+}
+//# sourceMappingURL=export.js.map

package/dist/commands/database/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../../src/commands/database/export.ts"],"names":[],"mappings":"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"}

package/dist/commands/database/insert.d.ts

@@ -0,0 +1,11 @@
+/**
+ * notion-cli db insert <db-id> --file <file.csv>
+ *
+ * Insert CSV rows as new pages in a Notion database.
+ * All rows must NOT have a _notion_id column value.
+ *
+ * This command is NOT idempotent (creates new pages each run).
+ */
+import { type Command } from 'commander';
+export declare function registerDbInsertCommand(db: Command): void;
+//# sourceMappingURL=insert.d.ts.map

package/dist/commands/database/insert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert.d.ts","sourceRoot":"","sources":["../../../src/commands/database/insert.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAczC,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CA6FzD"}

package/dist/commands/database/insert.js

@@ -0,0 +1,93 @@
+/**
+ * notion-cli db insert <db-id> --file <file.csv>
+ *
+ * Insert CSV rows as new pages in a Notion database.
+ * All rows must NOT have a _notion_id column value.
+ *
+ * This command is NOT idempotent (creates new pages each run).
+ */
+import {} from 'commander';
+import { readFileSync } from 'node:fs';
+import { getClient, resolveDataSourceId } from '../../lib/client.js';
+import { csvToRows } from '../../lib/csv.js';
+import { buildNotionProperties } from '../../lib/db-properties.js';
+import { printSuccess, printError, isJsonMode } from '../../lib/output.js';
+import { isDryRun } from '../../lib/safety.js';
+import { withRateLimit } from '../../lib/rate-limit.js';
+import { parseNotionId } from '../../utils/id.js';
+import {} from '../../lib/types.js';
+import { toCliError, ValidationError } from '../../lib/errors.js';
+import * as logger from '../../utils/logger.js';
+export function registerDbInsertCommand(db) {
+    db.command('insert')
+        .description('Insert CSV rows as new pages into a Notion database.')
+        .argument('<db-id>', 'Notion database ID or URL')
+        .requiredOption('-f, --file <path>', 'Path to CSV file')
+        .action(async (rawId, cmdOpts) => {
+        try {
+            const opts = db.optsWithGlobals();
+            const rawIdParsed = parseNotionId(rawId);
+            const client = getClient(opts.token);
+            const dbId = await resolveDataSourceId(client, rawIdParsed);
+            const csvContent = readFileSync(cmdOpts.file, 'utf-8');
+            const rows = csvToRows(csvContent);
+            if (rows.length === 0) {
+                throw new ValidationError('CSV file contains no data rows.');
+            }
+            const rowsWithId = rows.filter((r) => r.id !== undefined);
+            if (rowsWithId.length > 0) {
+                throw new ValidationError(`All rows must be new (no _notion_id). Found ${String(rowsWithId.length)} row(s) with _notion_id. Use "db update" for existing rows.`);
+            }
+            const dataSource = await withRateLimit(() => client.dataSources.retrieve({ data_source_id: dbId }), 'dataSources.retrieve');
+            const schemaProps = dataSource.properties;
+            logger.info(`Insert: ${String(rows.length)} new rows to create.`);
+            if (isDryRun(opts.dryRun)) {
+                if (isJsonMode()) {
+                    printSuccess({
+                        databaseId: dbId,
+                        toCreate: rows.length,
+                        dryRun: true,
+                    });
+                }
+                else {
+                    logger.info(`Dry run: Would insert ${String(rows.length)} new rows into database ${dbId}.`);
+                }
+                return;
+            }
+            let created = 0;
+            let failed = 0;
+            await Promise.all(rows.map(async (row) => {
+                try {
+                    const properties = buildNotionProperties(row.properties, schemaProps);
+                    await withRateLimit(() => client.pages.create({
+                        parent: { database_id: rawIdParsed },
+                        properties: properties,
+                    }), 'pages.create');
+                    created++;
+                }
+                catch (err) {
+                    failed++;
+                    logger.warn(`Failed to create row: ${String(err)}`);
+                }
+            }));
+            const result = {
+                databaseId: dbId,
+                created,
+                failed,
+                total: rows.length,
+            };
+            if (isJsonMode()) {
+                printSuccess(result);
+            }
+            else {
+                logger.success(`Insert complete: ${String(created)} created, ${String(failed)} failed.`);
+            }
+        }
+        catch (err) {
+            const cliErr = toCliError(err);
+            printError(cliErr.code, cliErr.message);
+            process.exitCode = cliErr.exitCode;
+        }
+    });
+}
+//# sourceMappingURL=insert.js.map

package/dist/commands/database/insert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert.js","sourceRoot":"","sources":["../../../src/commands/database/insert.ts"],"names":[],"mappings":"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"}

package/dist/commands/database/list.d.ts

@@ -0,0 +1,10 @@
+/**
+ * notion-cli db list
+ *
+ * List all Notion databases accessible to the integration.
+ *
+ * This command is idempotent and read-only.
+ */
+import { type Command } from 'commander';
+export declare function registerDbListCommand(db: Command): void;
+//# sourceMappingURL=list.d.ts.map