Notion MCP Server (로컬)
Notion API를 MCP 도구로 노출해 페이지·데이터 소스를 읽고 수정하게 하는 셀프호스팅 Notion MCP 서버입니다.
makenotion 제작 · 비공식 한국어 정리
언제 쓰면 좋나
Notion 워크스페이스의 페이지와 데이터베이스를 에이전트가 직접 조회·편집하게 하고 싶을 때 쓸 수 있습니다. 다만 Notion은 이 로컬 버전 대신 호스팅형 Remote Notion MCP 사용을 권하므로, 로컬 실행이 꼭 필요한 경우에 고려하는 편이 맞습니다. 페이지 내용을 마크다운으로 읽고 쓰는 도구도 제공합니다.
설치
npx -y @notionhq/notion-mcp-serverNotion 내부 통합(integration) 토큰 발급 후 NOTION_TOKEN 환경변수로 전달, 사용할 페이지에 통합 연결 필요
주의할 점
더 이상 적극적으로 유지보수되지 않으며 향후 저장소가 종료될 수 있다고 명시되어 있습니다. v2.0.0에서 데이터베이스 관련 도구 이름이 바뀌어, 이전 도구명을 하드코딩한 프롬프트는 수정이 필요합니다.
커뮤니티 반응
연결만 되면 Claude Code 작업 결과를 노션 DB에 바로 기록할 수 있어 유용하다는 후기가 있지만, 문서대로 설치하면 인증이 되지 않아 내부 통합 토큰을 직접 만들어야 했다는 경험담도 있습니다. GitHub에는 페이지 생성 시 객체 파라미터가 문자열로 넘어가 실패하는 버그와 OAuth 토큰이 너무 자주 만료된다는 불만이 올라와 있습니다. HN에서는 도구 설명이 길어 컨텍스트를 많이 차지한다는 지적도 나왔습니다. 로컬 서버는 유지보수가 끝났으니 호스티드 Notion MCP를 고려하는 편이 낫습니다.
다른 사용자들의 공개 후기를 요약했습니다 · 2026-10-09 확인
