Skip to main content
This page has been deprecated and is no longer maintained.The legacy Cursor custom-agent connector is no longer available for new setup.Use the Cursor external agent instead.
Cursor now runs in Notion as an external agent. To create one, open Agents in Notion’s sidebar, select New Agent, and choose Cursor. The current setup flow, prerequisites, billing notes, and troubleshooting guidance live in the Connect Cursor to Notion Help Center article. If you already configured the legacy Cursor connector, existing connections may continue to work and can still be reconnected with a fresh Cursor API key.

​
Use a service account for team agents

Cursor service account API keys are supported anywhere this guide asks for a Cursor API key, and are recommended for team-owned agents. A service account keeps the agent tied to a shared Cursor identity instead of a teammate’s personal account. The service account’s GitHub app authorization controls which repositories Cursor agents can access and open pull requests against. Pull requests and commits created by the agent are attributed to the service account, such as cursoragent, rather than the Notion member who started the run. For new Cursor agents, use the external-agent flow instead of adding Cursor from a custom agent’s Tools & access settings. For more context about external agents in Notion, see the External Agents Help Center category.