Provides a REST API interface for interacting with Notion's API, allowing for searching, database operations (creation, querying, updating), page management, block manipulation, user information retrieval, and comment functionality.
Integrates Swagger UI to provide interactive API documentation, available at the /api-docs endpoint with OpenAPI schema accessible at /openapi.json.
๐ง Notion MCP Server
๋ ํผ๋ฐ์ค ์์

Master Control Panel for Notion
Your Notion workspace, now supercharged as a real-time backend server.
Notion MCP(Server)๋ Notion์ ๋จ์ํ ๋
ธํธ ์ฑ์ด ์๋,
์กฐ์ง์ ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ์ค์๊ฐ์ผ๋ก ์ ์ดํ ์ ์๋ ๋ง์คํฐ ์คํผ๋ ์ดํ
์์คํ
์ผ๋ก ์งํ์ํค๋ ์๋ฒ์
๋๋ค.
Related MCP server: SystemPrompt MCP Notion Server
๐ Features
๐ Notion API ๊ธฐ๋ฐ ํตํฉ ๋ฐฑ์๋
Notion DB๋ฅผ ์ค์ API์ฒ๋ผ ์ฝ๊ณ , ์ ์ ํ๊ณ , ๊ฐ๊ณตํด์.
โก SSG/SSR ์น์ฌ์ดํธ์ฉ JSON ์๋ํฌ์ธํธ ์ ๊ณต
Next.js, Nuxt ๋ฑ ํ๋ก ํธ ํ๋ ์์ํฌ์ ์ฝ๊ฒ ์ฐ๋ ๊ฐ๋ฅํด์.
๐งญ ์ปจํ ์ธ ์บ๋ฆฐ๋, ์ฑ์ฉ ์์คํ , ์ ๋ฌด ๊ด๋ฆฌ ๋ฑ ๋ค์ํ MCP ํ ํ๋ฆฟ ์ง์
๐ ๋ณด์ ํ ํฐ ์ธ์ฆ ์ง์ (API Key ๊ธฐ๋ฐ)
โ๏ธ MCP๋ฅผ ํตํด Notion์ CMS, CRM, ATS, Task Manager๋ก ์์ ๋กญ๊ฒ ํ์ฅํด๋ณด์ธ์.
๐ ๊ธฐ์ ์คํ
Node.js / TypeScript
Express.js ๊ธฐ๋ฐ REST API
Notion Official API v1
.cursor/mcp.json ํ๊ฒฝ๋ณ์ ๊ธฐ๋ฐ ๊ตฌ์ฑ
Docker ์ปจํ ์ด๋ ์ง์
๐งช ํ์ฅ ์์ด๋์ด
GPT API์ ์ฐ๋ํด ์์ฝ, ์๋ ๋ถ๋ฅ ๊ธฐ๋ฅ ์ถ๊ฐ
Slack, Discord Webhook ์ฐ๊ฒฐ๋ก ์ค์๊ฐ ์๋ฆผ
๊ด๋ฆฌ์์ฉ Dashboard UI ์ถ๊ฐ (React, Next.js ๊ธฐ๋ฐ)
์บ์ฑ ์๋ฒ(Firebase/Supabase) ์ฐ๋์ผ๋ก ์ฑ๋ฅ ๊ฐ์
๐งฌ ์ Notion MCP Server์ธ๊ฐ์?
์ฐ๋ฆฌ๋ ๋ชจ๋ Notion์ ์ฌ๋ํ์ง๋ง, ๊ทธ ์์ ๋ฐ์ดํฐ๋ฅผ ์ค์ ๋ก "์ ์ด"ํ๊ฑฐ๋ "ํ์ฉ"ํ๋ ๋ฐ๋ ํ๊ณ๋ฅผ ๋๊ปด์. ๊ทธ๋์ Notion MCP๋ ๋จ์ํ ํตํฉ ๋๊ตฌ๊ฐ ์๋๋ผ, Notion์ โ์ง์ง ๋ฐฑ์คํผ์คโ๋ก ๋ง๋๋ OS์ ๋๋ค.
๐ฌ Contact
๋ง๋ ์ฌ๋: ํ๋ฆฌ์๋น (@HariFatherKR) ์ง๋ฌธ์ด๋ ํ์ ์ ์์ ์ธ์ ๋ ์ง Issues ๋๋ Discussions์ ๋จ๊ฒจ์ฃผ์ธ์!
๋น์ ์ Notion, ์ด์ ๋ ์๋ฒ๊ฐ ๋ฉ๋๋ค. โ
Notion MCP Server
๐ณ Docker๋ก ์คํํ๊ธฐ
์ค๋น ์ฌํญ
Docker ๋ฐ Docker Compose ์ค์น
Notion API ํ ํฐ ๋ฐ๊ธ (Notion Developers์์ ๋ฐ๊ธ ๊ฐ๋ฅ)
ํ๊ฒฝ ์ค์
.envํ์ผ ์์ฑ:
๋์ปค ์ด๋ฏธ์ง ๋น๋ ๋ฐ ์คํ
์ง์ ์คํ (๋์ปค ์์ด)
์๋ฒ๊ฐ ์คํ๋๋ฉด ๋ค์ ์ฃผ์๋ก ์ ์ํ ์ ์์ต๋๋ค:
API ์๋ฒ: http://localhost:3000
API ๋ฌธ์: http://localhost:3000/api-docs