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

# Notion Agents

> Add Human Intelligence as a custom MCP server so your Notion Agents can reason over governed people data.

Connecting Human Intelligence to Notion lets you build Notion Agents grounded in your people data — agents that pull live metrics into your team's workspace and stay in sync with your governed definitions.

## What you'll need

| Field          | Value                                        |
| -------------- | -------------------------------------------- |
| MCP server URL | `https://chat.svc.humanintelligence.com/mcp` |
| Name           | `Human Intelligence`                         |

## Setup steps

<Steps>
  <Step title="Create a new agent">
    In the left nav, click **+ New agent** under the **Agents** subsection.
  </Step>

  <Step title="Start from a blank agent">
    In the modal that appears, click **Create Blank** in the top right corner.
  </Step>

  <Step title="Add a connection">
    In the resulting agent view, click **+ Add connection**. You'll find this in the **Tools and access** section of the **Settings** panel on the right.
  </Step>

  <Step title="Add a custom MCP server">
    In the modal that appears, click **+ Add custom MCP** in the lower left corner.
  </Step>

  <Step title="Enter the server URL">
    Enter the MCP server URL as `https://chat.svc.humanintelligence.com/mcp`.
  </Step>

  <Step title="Enter the name">
    Enter the server Name as `Human Intelligence`.
  </Step>

  <Step title="Connect">
    Click the **Connect** button in the lower right corner.
  </Step>

  <Step title="Sign in to Human Intelligence">
    If prompted, complete authentication by logging in with **Human Intelligence**.
  </Step>

  <Step title="Allow access">
    Click **Allow Access** to grant Notion Agents access to your Human Intelligence user account.
  </Step>

  <Step title="Start building">
    Start building with Notion Agents and your people data via Human Intelligence.
  </Step>
</Steps>

## Verifying the connection

Ask your agent something only your governed data can answer — for example, "What datasets do I have access to in Human Intelligence?" The agent should call the Human Intelligence MCP server and return your organization's datasets.

<Note>
  The agent connects **as the person who authorized it**. It sees exactly the
  data that account is permitted to see — no more. Keep this in mind when
  sharing an agent with teammates whose access differs from yours. See [Identity
  and permissions](/mcp/overview#identity-and-permissions).
</Note>

<Tip>
  Agents you build this way inherit your governed metric definitions, so a
  number in Notion matches the same number in Human Intelligence.
</Tip>