Notion MCP Server (공식) — Claude Code MCP 서버
Notion 워크스페이스의 페이지·데이터베이스·댓글을 AI가 읽고 쓸 수 있게 하는 공식 MCP 서버. makenotion에서 직접 유지보수.
Notion MCP Server는 Notion을 만든 makenotion에서 직접 유지보수하는 공식 MCP(Model Context Protocol) 서버로, Claude Code 같은 MCP 호환 AI 클라이언트가 Notion 워크스페이스의 페이지·데이터베이스·댓글을 직접 읽고 쓸 수 있게 연결해 줍니다. 그동안 "노트는 Notion에, 작업은 AI 도구에"로 흩어져 있던 흐름을 하나로 묶어, 대화 중에 AI가 회의록을 페이지로 정리하거나, 데이터베이스 항목을 조회·생성·수정하고, 특정 페이지에 댓글을 남기는 일을 사람이 창을 오가지 않고 처리할 수 있게 합니다.
핵심적으로 해결하는 문제는 "지식이 Notion에 쌓여 있는데 AI는 그걸 모른다"는 단절입니다. MCP 서버를 연결하면 AI가 사내 위키·프로젝트 보드·문서를 컨텍스트로 활용해 답하거나, 반대로 정리한 결과를 Notion에 곧바로 적재할 수 있습니다. 대표적인 활용은 회의·리서치 내용 요약 후 페이지 생성, 데이터베이스 기반 태스크/이슈 트래킹의 조회·갱신, 문서 초안 작성과 협업용 댓글 달기, 흩어진 노트의 검색·통합 등입니다.
이 서버는 npx 방식으로 가볍게 추가할 수 있으며 인증에는 Notion 통합(integration) 토큰인 NOTION_TOKEN이 필요합니다. 토큰이 접근할 수 있는 페이지·데이터베이스의 범위는 Notion 쪽 통합 공유 설정에 따라 정해지므로, 연동 전에 어떤 공간을 노출할지 명확히 정해 두는 것이 중요합니다.
추천 사용자: 개인 지식관리(PKM)·문서·위키를 Notion으로 운영하는 개인, 프로젝트 문서와 태스크 보드를 Notion에서 관리하는 팀, AI에게 사내 문서 컨텍스트를 주거나 정리 결과를 자동 적재하고 싶은 운영·콘텐츠·개발 실무자입니다. 정확한 도구 목록·인증 옵션·원격(remote) 연결 방식은 버전에 따라 달라질 수 있으니 공식 GitHub 저장소(makenotion/notion-mcp-server) 문서를 함께 확인하는 것을 권장합니다.
언제 쓰나
팀·개인 지식과 문서가 Notion에 모여 있고, AI가 그 내용을 컨텍스트로 활용하거나 정리 결과를 곧바로 Notion에 적재하길 원할 때 적합합니다. 회의록·리서치 요약을 페이지로 만들기, Notion 데이터베이스 기반 태스크/이슈 조회·생성·수정, 문서 초안 작성과 협업 댓글 달기, 위키 검색·통합 같은 워크플로에 특히 유용합니다. 반대로 단순 일회성 메모나 Notion을 쓰지 않는 환경이라면 굳이 필요하지 않습니다.
설치
claude mcp add notion -- npx -y @notionhq/notion-mcp-server설치 후 환경변수 NOTION_TOKEN(Notion 통합 토큰)이 필요합니다. Notion에서 internal integration을 만들어 토큰을 발급한 뒤, AI가 접근해야 하는 페이지·데이터베이스를 해당 통합과 공유(Connections 추가)해야 도구가 실제로 보입니다. 공유되지 않은 공간은 토큰이 있어도 접근되지 않습니다. npx 실행에는 Node.js 환경이 필요하며, 도구 목록·원격 연결 등 세부 옵션은 버전에 따라 다를 수 있으니 공식 저장소(makenotion/notion-mcp-server) 문서 확인을 권장합니다.
필요 키(직접 발급, 플레이스홀더): NOTION_TOKEN
보안 주의
NOTION_TOKEN은 워크스페이스 데이터 접근 자격증명이므로 평문 노출·커밋을 금지하고 환경변수나 시크릿 매니저로만 관리하세요. 토큰이 공유받은 모든 페이지·DB에 AI가 읽기·쓰기·수정·삭제할 수 있으니 최소 권한 원칙으로 꼭 필요한 공간만 통합과 공유하고, 민감 문서가 든 공간은 분리하는 것이 안전합니다. 외부에서 들어온 페이지·댓글 내용에 악의적 지시가 섞이는 프롬프트 인젝션 위험이 있으므로, AI가 그 내용을 근거로 페이지 생성·수정 등 쓰기 동작을 할 때는 검토 단계를 두길 권장합니다. 토큰 유출 시 즉시 회전(재발급)하세요.
자주 묻는 질문
설치하려면 무엇이 필요한가요?
Node.js 환경과 Notion 통합 토큰(NOTION_TOKEN)이 필요합니다. Notion에서 internal integration을 만들어 토큰을 발급하고, AI가 다룰 페이지·데이터베이스를 그 통합과 공유해야 실제로 접근됩니다.
AI가 내 Notion 전체를 보게 되나요?
아닙니다. 발급한 통합 토큰이 공유받은 페이지·데이터베이스에만 접근합니다. Notion의 Connections 설정에서 공유 범위를 조절할 수 있으므로 필요한 공간만 연결하는 것이 안전합니다.
읽기뿐 아니라 쓰기도 되나요?
네. 권한이 부여된 범위 안에서 페이지·데이터베이스 항목 생성·수정과 댓글 작성이 가능합니다. 쓰기·삭제 동작은 되돌리기 어려울 수 있으니 중요한 변경은 검토 후 실행하길 권장합니다.