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

# Connect the Notion MCP server

> Connect Notion's hosted MCP server to Spojit with one-click OAuth to search, read, create, and update pages and databases from your workflows.

Notion hosts an MCP server that lets AI agents search your workspace and read, create, and update pages and databases. Connect it to Spojit to file meeting notes, update a project database from a workflow, or pull a spec into an agent's context.

<Note>
  Spojit connects to this server through a [custom MCP server](/connectors/remote-mcp-servers/custom) connection, so you add it with **Add custom server** rather than from the connector catalog. Notion maintains it and decides which tools it offers; see [Notion's MCP documentation](https://developers.notion.com/guides/mcp/overview) for the current list.
</Note>

## Before you start

* A Notion account in the workspace you want to connect. The connection can reach the same content you can reach in Notion.
* Workspace owners can review and limit MCP client connections under **Settings > Connections** ([Notion Help](https://www.notion.com/help/notion-mcp)).

## Server URL

```
https://mcp.notion.com/mcp
```

## Connect in Spojit

<Steps>
  <Step title="Add a custom server">
    Go to **Connections** and click **Add custom server**. Enter a **Name** such as `Notion` and paste the **Server URL**.
  </Step>

  <Step title="Keep Auto authentication">
    Leave **Authentication** on **Auto**, choose a visibility, and click **Save & connect**.
  </Step>

  <Step title="Approve access in Notion">
    Notion opens its authorization page. Choose the workspace and approve. Spojit marks the connection **Connected** and refreshes the token automatically.
  </Step>
</Steps>

## Use it in a workflow

Add a **Connector** node, pick your Notion server under **Custom Servers**, and choose **Agent Mode** or **Direct Mode**. See [Use a custom server in a workflow](/connectors/remote-mcp-servers/custom#use-a-custom-server-in-a-workflow).

## Troubleshooting

<AccordionGroup>
  <Accordion title="A page or database is missing">
    The connection acts as the Notion user who approved it. Confirm that user can open the page in Notion.
  </Accordion>

  <Accordion title="The connection stops working">
    A workspace owner or organization admin may have revoked it under **Settings > Connections**. Click **Reconnect** on the connection to approve access again.
  </Accordion>
</AccordionGroup>

## Learn more

* [Notion MCP overview](https://developers.notion.com/guides/mcp/overview)
* [Connect AI tools with Notion MCP](https://www.notion.com/help/notion-mcp)

<Snippet file="start-free.mdx" />
