Notion MCP Server 来啦！

Captaincc2025-04-10 16:36

Notion MCP Server

This project implements an MCP server for the Notion API.

Installation

Add the following to your .cursor/mcp.json or claude_desktop_config.json (MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json)

perl 复制代码

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

Don't forget to replace ntn_**** with your integration secret. Find it from your integration configuration tab:

Ensure relevant pages and databases are connected to your integration.

Examples

Using the following instruction

csharp 复制代码

Comment "Hello MCP" on page "Getting started"

AI will correctly plan two API calls, v1/search and v1/comments, to achieve the task

Similarly, the following instruction will result in a new page named "Notion MCP" added to parent page "Development"

sql 复制代码

Add a page titled "Notion MCP" to page "Development"

You may also reference content ID directly

css 复制代码

Get the content of page 1a6b35e6e67f802fa7e1d27686f017f2

Development

Build

arduino 复制代码

npm run build

Execute

css 复制代码

npx -y --prefix /path/to/local/notion-mcp-server @notionhq/notion-mcp-server

Publish

arduino 复制代码

npm publish --access public