Notion MCP Server

🧠 Notion MCP Server

레퍼런스 영상

Master Control Panel for Notion
Your Notion workspace, now supercharged as a real-time backend server.

Notion MCP(Server)는 Notion을 단순한 노트 앱이 아닌,
조직의 모든 데이터를 실시간으로 제어할 수 있는 마스터 오퍼레이팅 시스템으로 진화시키는 서버입니다.

🚀 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로 실행하기

준비 사항

1. Docker 및 Docker Compose 설치
2. Notion API 토큰 발급 (Notion Developers에서 발급 가능)

환경 설정

1. .env 파일 생성:

PORT=3000
NOTION_TOKEN=your_notion_token_here

도커 이미지 빌드 및 실행

# 도커 이미지 빌드 및 컨테이너 실행
docker-compose up -d

# 로그 확인
docker-compose logs -f

# 컨테이너 중지
docker-compose down

직접 실행 (도커 없이)

# 의존성 설치
npm install

# 서버 실행
npm start

서버가 실행되면 다음 주소로 접속할 수 있습니다:

• API 서버: http://localhost:3000
• API 문서: http://localhost:3000/api-docs