Notion

Add Cakewalk's MCP Gateway as a custom MCP server in a Notion Custom Agent. Available on Business and Enterprise plans after a workspace admin enables custom MCP servers.

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 from Notion.