The Notion Agent APIs are in public beta: an app outside Notion can open a session with a Custom Agent, send it a message, stream the reply, submit an action and page through the session’s event history.

The beta also manages agents programmatically — query the agents a token can reach, read per-agent usage insights, set credit limits, and enable, disable or delete agents one at a time or in an asynchronous batch. Calls authenticate with a personal access token or a connection token that carries the Interact with agents capability. The same session control is available from any MCP client: Notion MCP gained tools to search and start sessions, send follow-ups, check or wait on status, stop a run and read session events. A JavaScript/TypeScript SDK on GitHub (makenotion/notion-agents-sdk-js) wraps the API as a typed layer over the official client; it is still labelled alpha and installs from source rather than from npm.

To start, follow the quickstart at developers.notion.com/guides/notion-agent-apis/quickstart with a personal access token.