Skip to main content
Notion’s custom agents can use a custom MCP server. Custom MCP servers are on the Business and Enterprise plans, and a workspace owner turns them on once.
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:
Each person signs in once per agent: the connection uses their Spiral organization and role. Guides for every tool in Notion: each tool’s prompts, options and price. If something does not work, see Troubleshooting.