notion-mcp-server은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

notion-mcp-server은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

notion-mcp-server은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. notion-mcp-server의 마지막 커밋은 2026년 9월 20일입니다.

notion-mcp-server은(는) 어디에 사용할 수 있나요?

AI 어시스턴트가 Notion 워크스페이스의 페이지를 검색하고 요약하도록 합니다. 편집기에서 자연어 지시를 받아 페이지 생성이나 댓글 작성을 자동화합니다. Notion과 내부 AI 에이전트 사이에 자체 호스팅 브리지를 구축합니다. AI 클라이언트가 변경할 수 있는 범위를 제한하기 위해 읽기 전용 통합을 실행합니다.

notion-mcp-server는 어떻게 설치하나요?

Notion에서 내부 통합을 만들고 토큰을 복사합니다 사용하려는 페이지를 통합에 연결합니다 NOTION_TOKEN을 사용해 npx로 MCP 설정을 클라이언트에 추가합니다: npx -y @notionhq/notion-mcp-server

notion-mcp-server은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/makenotion/notion-mcp-server

makenotion/notion-mcp-server

AI 어시스턴트가 Notion API를 통해 Notion 워크스페이스를 읽고 수정할 수 있게 하는 자체 호스팅 MCP 서버로, 현재는 Notion의 호스팅형 Remote MCP로 대체되었습니다.

대체할 수 있는 제품:Notion AI

GitHub에서 보기

스타: 4,671
포크: 638
열린 이슈: 202
마지막 커밋: 30일 전

어떤 프로젝트인가요?

이 프로젝트는 Notion API를 감싸는 MCP(Model Context Protocol) 서버입니다. 검색, 페이지 읽기 및 생성, 데이터베이스와 데이터 소스 쿼리, 댓글 추가 등의 Notion 작업을 도구로 제공해 Claude Desktop, Cursor, Zed 같은 AI 클라이언트에서 호출할 수 있습니다. 기본적으로 로컬에서 stdio로 실행되며, bearer token 인증을 사용하는 Streamable HTTP 서버로도 실행할 수 있습니다. Notion internal integration token으로 접근을 제어하며, 해당 통합에 명시적으로 연결된 페이지만 볼 수 있습니다.

버전 2.0.0에서는 Notion API 버전 2025-09-03으로 전환했습니다. 이 버전에서는 데이터베이스 대신 데이터 소스를 주요 추상화로 사용하고, 페이지 콘텐츠를 Markdown으로 읽고 수정하는 도구 두 가지를 추가합니다. Notion MCP 팀은 이 저장소가 더 이상 활발히 유지보수되지 않으며, 시맨틱 검색과 OAuth를 지원하는 호스팅형 Remote Notion MCP를 권장한다고 밝혔습니다. 이 버전을 설정하려면 여전히 통합을 만들고, 페이지를 공유하고, JSON 클라이언트 설정을 수정해야 합니다.

서버는 npx나 Docker로 실행하거나 npm으로 소스에서 빌드할 수 있습니다. 선택적으로 토큰 전달 모드를 사용할 수 있어, 하나의 배포 환경에서 여러 Notion 통합을 지원할 수 있습니다.

핵심 기능

01Notion API 작업을 AI 클라이언트용 MCP 도구로 제공합니다.
02stdio와 Streamable HTTP 전송 방식을 지원합니다.
03버전 2.0.0에서 페이지 콘텐츠를 Markdown으로 읽고 수정합니다.
04데이터 소스 생성, 업데이트, 쿼리를 지원합니다.
05NOTION_TOKEN 또는 OPENAPI_MCP_HEADERS를 통해 Notion 통합 토큰을 받습니다.
06여러 통합을 위한 요청별 토큰 전달 기능을 선택적으로 제공합니다.

활용 사례

AI 어시스턴트가 Notion 워크스페이스의 페이지를 검색하고 요약하도록 합니다.
편집기에서 자연어 지시를 받아 페이지 생성이나 댓글 작성을 자동화합니다.
Notion과 내부 AI 에이전트 사이에 자체 호스팅 브리지를 구축합니다.
AI 클라이언트가 변경할 수 있는 범위를 제한하기 위해 읽기 전용 통합을 실행합니다.

빠른 시작

1
Notion에서 내부 통합을 만들고 토큰을 복사합니다
2
사용하려는 페이지를 통합에 연결합니다
3
NOTION_TOKEN을 사용해 npx로 MCP 설정을 클라이언트에 추가합니다
npx -y @notionhq/notion-mcp-server

사용 전 알아둘 점

Notion은 대신 호스팅 Remote Notion MCP 사용을 권장하며, 이 저장소는 더 이상 적극적으로 유지 관리되거나 지원되지 않습니다.
이슈와 풀 리퀘스트를 적극적으로 모니터링하지 않으며 프로젝트가 종료될 수 있습니다.
검색은 키워드로만 가능하고 페이지 콘텐츠 도구도 호스팅 버전에 비해 제한적입니다.
통합 토큰을 수동으로 설정하고 페이지를 공유해야 합니다.

토픽

#mcp #notion #notion-api #ai-agents #typescript #llm-tools #self-hosted

자주 묻는 질문

notion-mcp-server은(는) 무엇인가요?: AI 어시스턴트가 Notion API를 통해 Notion 워크스페이스를 읽고 수정할 수 있게 하는 자체 호스팅 MCP 서버로, 현재는 Notion의 호스팅형 Remote MCP로 대체되었습니다. 이 프로젝트는 Notion API를 감싸는 MCP(Model Context Protocol) 서버입니다. 검색, 페이지 읽기 및 생성, 데이터베이스와 데이터 소스 쿼리, 댓글 추가 등의 Notion 작업을 도구로 제공해 Claude Desktop, Cursor, Zed 같은 AI 클라이언트에서 호출할 수 있습니다. 기본적으로 로컬에서 stdio로 실행되며, bearer token 인증을 사용하는 Streamable HTTP 서버로도 실행할 수 있습니다. Notion internal integration token으로 접근을 제어하며, 해당 통합에 명시적으로 연결된 페이지만 볼 수 있습니다.
notion-mcp-server은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?: notion-mcp-server은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
notion-mcp-server은(는) 아직 유지보수되고 있나요?: 활발히 유지보수 중. notion-mcp-server의 마지막 커밋은 2026년 9월 20일입니다.
notion-mcp-server은(는) 어디에 사용할 수 있나요?: AI 어시스턴트가 Notion 워크스페이스의 페이지를 검색하고 요약하도록 합니다. 편집기에서 자연어 지시를 받아 페이지 생성이나 댓글 작성을 자동화합니다. Notion과 내부 AI 에이전트 사이에 자체 호스팅 브리지를 구축합니다. AI 클라이언트가 변경할 수 있는 범위를 제한하기 위해 읽기 전용 통합을 실행합니다.
notion-mcp-server는 어떻게 설치하나요?: Notion에서 내부 통합을 만들고 토큰을 복사합니다 사용하려는 페이지를 통합에 연결합니다 NOTION_TOKEN을 사용해 npx로 MCP 설정을 클라이언트에 추가합니다: npx -y @notionhq/notion-mcp-server
notion-mcp-server은(는) 어디서 받을 수 있나요?: 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/makenotion/notion-mcp-server

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.