1
Allow custom MCP servers
A workspace owner opens Settings › Connections, then the Manage tab, and turns on Enable custom MCP
servers. Where members may install only approved connections, also add Spiral under Approved connections ›
Add approved connection › Custom MCP server with the URL below.
2
Add Spiral to a custom agent
Open the custom agent (or create one), then Settings › Tools & Access › Add connection › Custom MCP server.
Paste this URL, name it Spiral, keep OAuth and click Connect.
3
Sign in to Spiral and approve
Spiral opens: sign in, pick the organization and click Authorize. No API key. Spiral gives the connection its
own key; Notion never sees it, and you can remove it under Settings › Connected apps in the console.
4
Choose the tools and try a prompt
Turn on the Spiral tools the agent may use. Tools that only read run on their own;
run and topup spend your
balance, so keep them on Always ask unless the agent should run tools without checking with you. Then ask: