suekou/mcp-notion-server

어떤 프로젝트인가요?

핵심 기능

• 01notion_find를 사용해 검색으로 페이지와 데이터 소스를 찾습니다.
• 02수정에 쓸 수 있는 안정적인 블록 ID를 포함해 페이지를 간결한 형식으로 읽습니다.
• 03항목을 조회하거나 생성하기 전에 데이터 소스 스키마를 살펴봅니다.
• 04간단한 값으로 데이터 소스 항목을 조회하고 생성합니다.
• 05단락, 제목, 목록, 할 일, 코드 블록 및 Markdown 추가 기능으로 페이지를 편집합니다.
• 06고급 블록, 데이터베이스, 댓글, 사용자 작업을 위한 Notion API 원시 도구를 제공합니다.

활용 사례

• Claude Desktop이나 Cursor의 AI 어시스턴트가 Notion 메모를 읽고 요약하도록 합니다.
• 에이전트 워크플로에서 Notion 데이터베이스를 조회하고 항목을 추가합니다.
• 생성된 Markdown 콘텐츠를 Notion 페이지에 자동으로 추가합니다.
• AI 기반 편집 프로세스로 페이지 블록을 일괄 업데이트합니다.

빠른 시작

1. 1

   Notion 내부 통합을 만들고 토큰을 복사합니다

2. 2

   NOTION_API_TOKEN을 설정하여 MCP 호스트 구성에 서버를 추가합니다

   npx -y @suekou/mcp-notion-server
3. 3

   구성을 저장한 후 MCP 호스트를 다시 시작합니다

사용 전 알아둘 점

• !서버가 액세스하려면 각 Notion 페이지 또는 데이터베이스를 통합과 명시적으로 공유해야 합니다.
• !개발하려면 Notion 통합 토큰과 Node.js 22 이상이 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

mcp-notion-server은(는) 무엇인가요?

AI 에이전트가 Notion API를 통해 Notion 페이지와 데이터베이스를 찾고, 읽고, 조회하고, 수정할 수 있게 하는 MCP 서버입니다. Notion 워크스페이스를 Claude Desktop, Cursor 등 MCP 호환 클라이언트에 연결하는 Model Context Protocol 서버입니다. Notion API 2026-03-11을 대상으로 하며, 현재의 데이터베이스 및 데이터 소스 모델에서 작동합니다. 응답은 간결하게 유지하고, 수정에 사용할 수 있도록 안정적인 블록 ID를 제공합니다.

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

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

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

6개월 이내 업데이트. mcp-notion-server의 마지막 커밋은 2026년 7월 31일입니다.

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

Claude Desktop이나 Cursor의 AI 어시스턴트가 Notion 메모를 읽고 요약하도록 합니다. 에이전트 워크플로에서 Notion 데이터베이스를 조회하고 항목을 추가합니다. 생성된 Markdown 콘텐츠를 Notion 페이지에 자동으로 추가합니다. AI 기반 편집 프로세스로 페이지 블록을 일괄 업데이트합니다.

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

Notion 내부 통합을 만들고 토큰을 복사합니다 NOTION_API_TOKEN을 설정하여 MCP 호스트 구성에 서버를 추가합니다: npx -y @suekou/mcp-notion-server 구성을 저장한 후 MCP 호스트를 다시 시작합니다

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

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