Build with Notion’s Developer Platform – Notion

Workers > sync:ZendeskChecking Zendesk...

Data Scout > tool:QueryConstructing query...

Claude CodeReceived user request...

Sync any data source into Notion.

Continuously upsert external records into a Notion Database with Workers, a declarative schema, and a persistent cursor.

zendeskSync.ts See example

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
Syncing 5 tickets...

Support Tickets

Build any tool for your agents.

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

presentationTool.ts See example

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
Running tool "createPresentation"...

Query any data warehouse

queryRevenueTool.ts See example

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

Trigger Notion workflows from anywhere.

Listen for incoming webhooks from any app, then run workflows with Notion Agents, pages, databases, and external APIs.

PR merged

Customer canceled

Candidate signed offer

Contract signed

Issue escalated

All of this, on a hosted runtime.

Workers are isolated sandboxes managed by Notion, so the code behind your syncs, tools, and workflows runs on our infra instead of your servers.

$ ntn deploy worker
[build] Deploying...
[build] Uploading to Notion...
[build] Worker updated...

Capabilities:
  tool  queryCustomers
  tool  moreOfficeSnacks
  sync  linearTickets

Alpha

Bring your favorite agents into Notion.

Use external agents like Claude, Cursor, Decagon, or one you’ve built, in a shared interface for your team and agents.

Mention

Collaborate with agents like teammates. @mention them in any page, comment, or chat with them directly.

Assign

Hand off work to your agents from any task, or trigger them in parallel.

Orchestrate

Watch agents think, call tools, and act across Notion and other apps with your review and approval when it matters.

BYO Agent

Bring your in‑house agents into Notion with the External Agents API. Notion gives them triggers, tools, and permissions so they show up as first‑class collaborators on all the same surfaces.

POST /sessions/{id}
POST /sessions/{id}/messages
GET  /sessions/{id}/events

CLI, API, MCP, SDK — LFG.

Notion CLIBeta

Let coding agents use token‑efficient commands to build and deploy syncs and tools to our Workers runtime.

Notion API

Turn docs into Markdown and build internal tools with PATs or shared connections.

Notion MCP

Search, read, and edit pages and databases with up to 91% fewer tokens.

Notion Agent SDKAlpha

Bring your Agents into any app. Trigger runs via API, keep multi-turn threads, and stream responses in real time.

import { NotionAgentsClient } from "@notionhq/agents-client";

const client = new NotionAgentsClient();
const agent = await client.agents.agent(id);

await agent.chat({
  message: "Hello, World!"
});

Any data. Any tool. Any agent. All in Notion.