> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion

> Give a Notion custom agent Spiral's tools as a custom MCP connection: paste one link, sign in, no API key.

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**.

```text theme={null}
https://api.spiral.ai/mcp
```

**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:

```text theme={null}
Find a text-to-image tool, tell me what one image costs, then generate a lighthouse at dawn.
```

Each person signs in once per agent: the connection uses their Spiral organization and role.

[Guides for every tool in Notion](https://spiral.ai/integrations/notion): each tool's prompts, options and price.

If something does not work, see [Troubleshooting](/docs/mcp-server.md#troubleshooting).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.