Skip to content

MCP setupDocumentation

Notion MCP Server

Connect your agent to Notion's hosted MCP server to search workspace pages, read databases and write notes, specs and tasks back.

npx workspacetemplates add notion-mcp --tool claude-code

Writes 1 file to your project root

.mcp.jsonmerge into your file8 lines · 112 BFile
{
  "mcpServers": {
    "notion": {
      "type": "http",
      "url": "https://mcp.notion.com/mcp"
    }
  }
}

What it does

Notion runs its own MCP server, so an agent can search your workspace, read a spec or a meeting page, query a database and create or update pages. It is a good fit when requirements or runbooks already live in Notion and you want them in the same chat as the code.

Setup is a URL and a browser sign-in. The agent only sees what your Notion account can see in the workspace you pick. Business and Enterprise workspaces can also use a token created by a workspace owner.

Example

you › Find the "Billing retries" spec in Notion and list the open questions at the bottom of it.

agent › Found "Billing retries spec" in Engineering Specs. Three open questions: max retry count, whether to email on the final failure, and how to treat expired cards.

Questions

How does it sign in?
The first use opens a Notion browser page where you choose the workspace and approve access. No token goes into the config.
Can it edit every page?
It acts as you, so it can change what you can change. Share only the pages you are comfortable with, or use a limited account.
Is the older /sse address still needed?
No. Notion says the SSE endpoint retires in February 2027. This setup uses the streamable HTTP address.
  • Box MCP Server

    MCP setupDocumentation

    Free
  • Context7 MCP Server

    MCP setupDocumentation

    Free
  • API Documentation

    SkillDocumentation

    Free
  • Architecture Decision Records

    SkillDocumentation

    Free