/dev/notion

Not just another CRUD API for your SaaS.

Start building with the Notion CLI or read our docs

Trusted by engineers at

$OpenAI$ $Figma$ $Ramp$ $Match Group$ $Vercel$ $NVIDIA$

Sync any data source into Notion.

Continuously upsert external records into a Notion database using Workers, a declarative schema and a persistent cursor.

and others

import { Worker } from "@notionhq/workers";

const worker = new Worker();

const tickets = worker.database("tickets", {
  type: "managed",
  initialTitle: "Support Tickets",
  primaryKeyProperty: "Tickets",
  schema: { properties: {
    "Tickets": Schema.title(),
    "CSAT score": Schema.select([{ name: "Very satisfied" }, ...]),
    "Feature tags": Schema.multiSelect([{ name: "Account access" }, ...]),
  }},
});

worker.sync("ticketsSync", {
  database: tickets,
  schedule: "5m",
  execute: async () => ({
    changes: (await zendesk.tickets.list()).map(t => ({
      type: "upsert" as const,
      key: t.id,
      properties: {
        "Tickets": Builder.title(t.subject),
        "CSAT score": Builder.select(t.csat),
        "Feature tags": Builder.multiSelect(...t.tags),
      },
    })),
  }),
})

Workers > sync:ticketsSync
Connecting. Found 5 new tickets...

Build any tool for your agents.

Write custom tools for Notion Agents that generate assets, query live data and access any API.

Generate assets from your docs

worker.tool("createPresentation", {
	title: "Create Presentation",
	description:
		"Reads a Notion page and creates a PowerPoint presentation from its content. Each heading becomes a new slide. The generated .pptx file is uploaded to the bottom of the page.",
	schema: j.object({
		pageId: j.string()
	}),
	execute: async ({ pageId }, { notion }) => {
		// Fetch page content as markdown and parse into slides
		const pageTitle = await getPageTitle(notion, pageId);
		const markdown = await getPageMarkdown(pageId);
		const slides = groupMarkdownIntoSlides(markdown, pageTitle);

		// Build the .pptx file
		const filename = `${pageTitle}.pptx`;
		const buffer = await buildPresentation(pageTitle, slides);

		// Upload to Notion and append to the page
		await uploadToNotion(notion, pageId, filename, buffer);

		return `Created presentation "${pageTitle}" with ${slides.length + 1} slides (1 title + ${slides.length} content) and added it to the page.`;
	},
});

Workers > tool:createPresentation

Query any data warehouse

worker.tool("queryRevenue", {
	title: "Query Revenue",
	description: "Run a SQL query against the deals warehouse table.",
	schema: j.object({
		query: j
			.string()
			.describe("e.g. SELECT SUM(amount) AS revenue WHERE region = 'North America'"),
	}),
	execute: async ({ query }) =>
		snowflake.query(query.replace(/(\s+WHERE|$)/i, " FROM deals$1")),
	});

Workers > tool:queryRevenue

Take actions in any app