The Model Context Protocol (MCP) is an open protocol that standardizes how applications provide context and tools to LLMs.

Notion maintains an open-source MCP server that allows AI agents to use the Notion API to add and retrieve context in Notion. The only requirement is that the app has an MCP client. Examples of supported MCP clients are listed here.

Setting up your MCP Client

Our MCP server works with any MCP Client. Select one that best fits your needs and use cases. We've listed some of the most common ones.

Although each client will have slightly different instructions, they all need the following MCP configuration JSON to connect to your local Notion MCP server.

When instructed, copy, paste, and save this code snippet in the appropriate file.

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
      }
    }
  }
}

📘

Replace ntn_**** with your integration secret

The bearer token in the snippet above is your own integration secret. To obtain it, either create a new integration or locate an existing one under Configuration > Internal Integration Secret