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

# Notion

> Connect Notion Custom Agents to the Affinity MCP Server

## Supported Notion surfaces

Affinity's MCP server is connected through **Notion Custom Agents**. The default Notion AI
assistant (Ask AI, Q\&A, search) does **not** support adding custom MCP servers. Only Custom
Agents do. If you don't see an **Agents** section in your sidebar, your plan or workspace
settings don't yet include Custom Agents.

## Prerequisites

**Affinity**

* **Plan**: Scale, Advanced, or Enterprise (required for API and MCP access).
* **For API key setup**: Generate an Affinity API key first. See
  [Authentication](/pages/mcp/authentication#api-key).
* **Admin setup**: None required by default. If an Affinity admin has disabled Notion under
  **Settings → Affinity MCP**, ask them to re-enable it.

**Notion**

* **Plan**: **Business** or **Enterprise**. Custom Agents and custom MCP servers are only
  available on these plans.
* **Admin setup** (required): A **workspace Owner** must enable custom MCP servers and, if
  desired, restrict who can create agents. See the next section for steps.

Notion supports both **OAuth** and **API key** authentication.

## Admin: Enable Custom MCP Servers

A workspace Owner must enable the feature for the workspace before any user can use it.

1. Navigate to **Settings** → **Notion AI** → **AI Connectors**.
2. Under **MCP Connections**, enable the toggle for **Enable custom MCP servers**.
3. Optionally, navigate to **Settings** → **Notion AI** → **Agents** and update **Control who can
   create agents** to restrict agent creation to certain users.

<Note>
  **Not an admin?** Send this to your workspace Owner: "Can you enable Settings → Notion AI → AI Connectors → Enable custom MCP servers so I can connect to the Affinity MCP server?"
</Note>

## User: Create an Agent (OAuth)

1. In the left sidebar, find the **Agents** section and click **New Agent**.
2. In the module that appears, click **Create blank** in the top right.
3. In the **Tools and access** section, click **Add connection**.
4. In the **Add connection** module, click **Add custom MCP** in the bottom left.
5. Enter the following configuration:
   * **MCP server URL**: `https://mcp.affinity.co/mcp`
   * **Name**: Affinity
   * **Authentication**: OAuth
6. Click **Connect** to initiate the OAuth flow. Once authorized, click **Save** in the top right.
7. The agent appears under the **Agents** section. Click on it to start chatting and using the
   MCP server.

## User: Create an Agent (API Key)

Generate an Affinity API key first. See [Authentication](/pages/mcp/authentication#api-key).

1. In the left sidebar, find the **Agents** section and click **New Agent**.
2. In the module that appears, click **Create blank** in the top right.
3. In the **Tools and access** section, click **Add connection**.
4. In the **Add connection** module, click **Add custom MCP** in the bottom left.
5. Enter the following configuration:
   * **MCP server URL**: `https://mcp.affinity.co/mcp`
   * **Name**: Affinity
   * **Authentication**: Bearer (set the **Token** field to your API key)
6. Click **Connect**. The MCP server will appear with its available tools.
7. Click **Save** in the top right. The agent appears under the **Agents** section. Click on it
   to start chatting and using Affinity data.

***

## Test your connection

Open the new agent and try one of these:

* *Find 3 companies I emailed in the last 30 days.*
* *Show me my upcoming meetings.*
* *Summarize recent activity on Acme Corp.*

If Affinity data comes back, you're set. If not, see [Troubleshooting](/pages/mcp/troubleshooting).