Notion MCP Server
Notion APIサーバー
リファレンスビデオ
Notion APIを使いやすくするためのカスタムサーバーです。 Express.jsを使用して実装されており、Notion APIのさまざまな機能をREST APIとして提供しています。
Related MCP server: Notion MCP Server
インストール方法
必要なパッケージのインストール:
npm install express cors @notionhq/client swagger-jsdoc swagger-ui-expressサーバーの実行:
node server.jsサーバーは http://localhost:3000で実行されます。
設定方法
server.jsファイルの
NOTION_TOKEN変数にNotion APIトークンを設定します。
const NOTION_TOKEN = '여기에_노션_API_토큰_입력';必要に応じて、PORT変数を変更して別のポートで実行できます。
API機能
検索API
POST /api/search: ノッションワークスペース内のページとデータベースの検索
データベースAPI
POST /api/databases: データベースの作成GET /api/databases/:id: データベース照会PATCH /api/databases/:id: データベースの更新POST /api/databases/:id/query: データベースクエリ
ページAPI
POST /api/pages: ページの生成GET /api/pages/:id: ページ情報の照会PATCH /api/pages/:id: ページの更新GET /api/pages/:page_id/properties/:property_id: ページ属性の検索
Block API
GET /api/blocks/:id: ブロック照会GET /api/blocks/:id/children: ブロック内容の照会PATCH /api/blocks/:id: ブロック更新PATCH /api/blocks/:id/children: ブロック内容の追加DELETE /api/blocks/:id: ブロックの削除
ユーザーAPI
GET /api/users: ユーザーリストの検索GET /api/users/:id: ユーザー検索GET /api/users/me:自分のユーザー情報を検索する
コメントAPI
POST /api/comments: コメントの生成GET /api/comments?block_id=...: コメントの照会
Cursor MCP統合
.cursor/mcp.jsonファイルに次の設定を追加します。
{
"mcpServers": {
"customApi": {
"url": "http://localhost:3000",
"toolNameStrategy": "url-path-segments"
}
}
}サーバーの実行中にCursorのMCP機能を使用してNotion APIにアクセスできます。
使用例
検索リクエストの例
// 페이지 검색
fetch('http://localhost:3000/api/search', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
filter: {
value: "page",
property: "object"
}
})
})
.then(response => response.json())
.then(data => console.log(data));ページ生成の例
// 새 페이지 생성
fetch('http://localhost:3000/api/pages', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
parent: {
page_id: "페이지_ID"
},
properties: {
title: {
title: [
{
text: {
content: "새 페이지 제목"
}
}
]
}
}
})
})
.then(response => response.json())
.then(data => console.log(data));データベース生成の例
// 데이터베이스 생성
fetch('http://localhost:3000/api/databases', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
parent: {
type: "page_id",
page_id: "페이지_ID"
},
title: [
{
text: {
content: "테스트 데이터베이스"
}
}
],
properties: {
"이름": {
"title": {},
"description": "제목 항목"
},
"상태": {
"description": "작업 상태",
"select": {
"options": [
{
"name": "진행 중",
"color": "blue"
},
{
"name": "완료",
"color": "green"
}
]
}
}
}
})
})
.then(response => response.json())
.then(data => console.log(data));APIドキュメント
API ドキュメントは、サーバーの実行時に次の URL で確認できます。
Swagger UI: http://localhost:3000/api-docs
OpenAPI スキーマ: http://localhost:3000/openapi.json
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Hosted Notion MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Hosted Airtable MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Marketo MCP server for AI. 130 tools to operate Marketo from Claude, Cursor, or ChatGPT.
Related MCP Servers
- AlicenseCqualityDmaintenanceA Model Context Protocol (MCP) server that exposes the official Notion SDK, allowing AI models to interact with Notion workspaces.1733 npm10Apache 2.0
- -licenseNot gradedqualityNot gradedmaintenanceAn MCP server that enables natural language interaction with the Notion API, allowing users to search, comment, create pages, and access content within their Notion workspace.265,848 npm-
- -licenseNot gradedqualityNot gradedmaintenanceA Model Context Protocol server that enables AI assistants to interact with Notion's API for reading, creating, and modifying Notion content through natural language interactions.-
- AlicenseNot gradedqualityDmaintenanceMCP server for the Notion API, enabling management of pages, blocks, databases, data sources, comments, and users through natural language.11 npm3MIT