# Notion

Notion Custom Agents can call external MCP servers. Add Cakewalk's gateway as a custom MCP server on the agent's Tools and Access page. The connection is per Custom Agent, not workspace wide.

## Requirements

* Notion Business or Enterprise plan. Custom MCP servers are not available on Free, Plus, or other tiers.
* A workspace admin needs to enable custom MCP servers once for the workspace before any user can add a connection.

## Install Method

Custom form inside a Notion Custom Agent. Notion stores the connection on the agent, not on your device. The connection to Cakewalk's gateway originates from Notion's servers.

## Step 1: Enable Custom MCP Servers (Workspace Admin, One Time)

A workspace admin does this once.

1. Open Notion **Settings**.
2. Click **Notion AI**.
3. Click **AI connectors**.
4. Toggle **Enable Custom MCP servers** on.

After this is on, any member who owns a Custom Agent can add a custom MCP server.

## Step 2: Open the Agent's Tools and Access

1. Open the Custom Agent you want to connect to Cakewalk.
2. Open the agent's **Settings**.
3. Go to **Tools & Access**.

## Step 3: Add the Cakewalk Gateway

1. Click **Add connection**.
2. Select **Custom MCP server**.
3. Enter the MCP server URL:

   ```
   https://mcp-gateway.getcakewalk.io/mcp
   ```
4. Give the connection a display name. **Cakewalk** is the recommended default.
5. Leave authentication as the OAuth option. Cakewalk's gateway authenticates over OAuth.
6. Click **Save**.

## Step 4: Authenticate

Notion opens the OAuth flow in your browser. Sign in with your Cakewalk account and approve the Connection. Notion stores the credentials on the agent.

## Step 5: Select Tools

After authentication, Notion lists the tools the Cakewalk gateway exposes. For each tool you want this agent to use:

* Toggle the tool on.
* Choose **Run automatically** or **Always ask** to control whether the agent invokes the tool without confirmation.

## Verifying It Works

In the Custom Agent's chat, ask the agent to list its available tools. The tools surfaced through the Cakewalk gateway appear in the response. In Cakewalk, the Notion card on **My Agents** flips to **Connected** after the first agent call.

## Per Agent Scope

The connection lives on the Custom Agent. Adding Cakewalk to one agent does not surface it on other Custom Agents in the same workspace. Repeat Steps 2 to 5 for each agent that needs Cakewalk access.

## Troubleshooting

* **Add connection does not show Custom MCP server:** the workspace admin has not yet enabled custom MCP servers. Ask an admin to complete Step 1.
* **Custom MCP server option is missing entirely:** the workspace is on Free, Plus, or another tier that does not include custom MCP servers. Custom MCP requires Business or Enterprise.
* **OAuth flow returns to an error page:** copy the full callback URL from your browser's address bar and paste it back into the prompt at notion.com.

## Learn more

* [MCP connections for custom agents](https://www.notion.com/help/mcp-connections-for-custom-agents) from Notion.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://www.cakewalk.security/docs/ai-agent-access/connections-and-integrations/agent-platforms/notion.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.