Skip to content

Notion (MCP token)

Notion's hosted MCP server, reached with a token instead of a browser sign-in, so agents can connect with nobody there to approve it. Needs a Business or Enterprise plan.

MCP serverPlanningWorks through the Grid

Hosted server

A hosted MCP server; you connect with an access token.
https://mcp.notion.com/mcp

Only workspace owners on Business and Enterprise plans can create a token, with New MCP token in Notion's Developer portal. Set it as NOTION_MCP_TOKEN in your environment. On other plans, use the Notion entry, which signs in through your browser.

Set it up in your agent

Pick your agent and copy the setup. ExonUI remembers your choice on other pages.
  1. Add it from the terminal

    Run this in your project folder. It saves the server for you, in this project only.

    Terminal
    claude mcp add --transport http notion-token https://mcp.notion.com/mcp --header 'Authorization: Bearer ${NOTION_MCP_TOKEN}'
  2. Or share it with your team

    Add this to .mcp.json at the project root and commit it. Teammates approve it the first time Claude Code starts.

    .mcp.json
    {
      "mcpServers": {
        "notion-token": {
          "type": "http",
          "url": "https://mcp.notion.com/mcp",
          "headers": {
            "Authorization": "Bearer ${NOTION_MCP_TOKEN}"
          }
        }
      }
    }
Good to know
  • Set NOTION_MCP_TOKEN in your environment before you start Claude Code. It reads the value each time it connects, so the token stays out of the config.

Check it works

Terminal
claude mcp list

Start a session and run /mcp to see the server, its status and its tools.