How to use Notion External Agents - AI Agents orchestration in Notion
So far, using Cursor, Claude Code, or other AI coding platforms, the main surface area for interacting with the AI agents has been the chat. Using chat is akin to constantly messaging with your teammates on Slack all day—draining, ineffective, and unnecessary for the most part.
There are more effective ways to organize work asynchronously, as often noted by Cal Newport and others. Methods that require little live interaction, while boosting one’s ability to work with focus on tasks uninterrupted.
Similarly, effective AI agent orchestration follows a clear work system; one where projects, tasks, specs, and statuses are clear to everyone involved, and things move across a pipeline to completion. You primarily oversee and quality-check the artefacts generated by the AI agents.
You could build a custom system for this purpose using MCP servers and API calls, or use Notion External Agents, which are built out of the box for this purpose while maintaining the customizability of the Notion platform.
Notion External Agents allow you to use Claude*, Cursor**, and other AI platforms without leaving the Notion workspace, effectively managing agents and your team in a single platform.
I can connect my Tasks data source and delegate some action items to Cursor/Claude or a chain of multiple agents, which will comment on and update the status in Notion. There’s access to all my documentation and context around the project, and the agents can easily read and write content directly in Notion to keep docs up to date.
To create an external agent in Notion, add a new custom agent in the dedicated sidebar section, and select the external agent option. Then follow the on-screen prompts to set it up, and customize triggers, instructions, and connections as in any custom agent. In this video I show the setup and usage of a Notion external agent.
Cursor Agent creation screen
The human work in software appears increasingly abstracted away from the building ground, moving into choices of what to build, its design, functionalities, and (especially) lack thereof. A clear work system provides the foundation for consistent clarity of choices, which in this paradigm matters.
*Claude external agents consume Notion credits.
**Cursor external agents are billed in Cursor and do not consume Notion credits.
