Notion MCP Server (로컬)

Notion API를 MCP 도구로 노출해 페이지와 데이터 소스를 읽고 수정하게 하는 셀프호스팅 Notion MCP 서버입니다.

MCP 서버업무 도구 연결makenotion 제작 · 비공식 한국어 정리
원본 저장소

설치 전에 Notion에서 내부 통합(integration) 토큰을 발급해 NOTION_TOKEN에 넣고, 쓸 페이지에 그 통합을 연결해야 합니다.MCP 설정 파일에 추가{"mcpServers": {"notionApi": {"command": "npx", "args": ["-y", "@notionhq/notion-mcp-server"], "env": {"NOTION_TOKEN": "ntn_****"}}}}강조한 부분은 내 값으로 바꿔서 쓰세요.

언제 쓰면 좋나

Notion 워크스페이스의 페이지와 데이터베이스를 에이전트가 직접 조회·편집하게 하고 싶을 때 쓸 수 있습니다. 다만 Notion은 이 로컬 버전 대신 호스팅형 Remote Notion MCP 사용을 권하므로, 로컬 실행이 꼭 필요한 경우에 고려하는 편이 맞습니다. 페이지 내용을 마크다운으로 읽고 쓰는 도구도 제공합니다.

설치

설치 전에 알아 둘 것

Notion에서 내부 통합(integration) 토큰을 발급해 NOTION_TOKEN에 넣고, 쓸 페이지에 그 통합을 연결해야 합니다.

  1. MCP 설정 파일에 추가
    {"mcpServers": {"notionApi": {"command": "npx", "args": ["-y", "@notionhq/notion-mcp-server"], "env": {"NOTION_TOKEN": "ntn_****"}}}}
    강조한 부분은 내 값으로 바꿔서 쓰세요.

주의할 점

더 이상 적극적으로 유지보수되지 않으며 향후 저장소가 종료될 수 있다고 명시되어 있습니다. v2.0.0에서 데이터베이스 관련 도구 이름이 바뀌어, 이전 도구명을 하드코딩한 프롬프트는 수정이 필요합니다.

커뮤니티 반응

연결만 되면 Claude Code 작업 결과를 노션 DB에 바로 기록할 수 있어 유용하다는 후기가 있지만, 문서대로 설치하면 인증이 되지 않아 내부 통합 토큰을 직접 만들어야 했다는 경험담도 있습니다. GitHub에는 페이지 생성 시 객체 파라미터가 문자열로 넘어가 실패하는 버그와 OAuth 토큰이 너무 자주 만료된다는 불만이 올라와 있습니다. HN에서는 도구 설명이 길어 컨텍스트를 많이 차지한다는 지적도 나왔습니다. 로컬 서버는 유지보수가 끝났으니 호스티드 Notion MCP를 고려하는 편이 낫습니다.

다른 사용자들의 공개 후기를 요약했습니다(2026-10-09 확인).

비슷한 도구

같은 업무 도구 연결 카테고리에서 별이 많은 도구입니다.