A
security-
licenseA
qualityMCP Server for the Notion API, enabling Claude to interact with Notion workspaces.
Last updated -
18
329
825
MIT License
Notion API 서버
레퍼런스 영상
노션 API를 간편하게 사용하기 위한 커스텀 서버입니다. Express.js를 사용하여 구현되었으며, Notion API의 다양한 기능을 REST API로 제공합니다.
설치 방법
필요한 패키지 설치:
npm install express cors @notionhq/client swagger-jsdoc swagger-ui-express
서버 실행:
node server.js
서버가 http://localhost:3000 에서 실행됩니다.
설정 방법
server.js 파일의
NOTION_TOKEN변수에 노션 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: 페이지 속성 조회
블록 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 기능을 사용하여 노션 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
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A custom server that provides a REST API interface for Notion, allowing easy access to Notion's functionality through Cursor's MCP feature.
Related MCP Servers
- Asecurity-licenseAqualityA high-performance MCP server that integrates Notion into AI workflows, enabling interaction with Notion pages, databases, and comments through a standardized protocol.Last updated -1824
- Asecurity-licenseAqualityNotion MCP Server is a MCP server implementation that enables AI assistants to interact with Notion's API.Last updated -13305136MIT License
Notion MCP Serverofficial
Asecurity-licenseAqualityAn MCP server that enables AI assistants to interact with the Notion API, allowing them to search, read, comment on, and create content in Notion workspaces through natural language commands.Last updated -1912,7353,269MIT License