remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides tools for reading, creating, and modifying Notion content through natural language interactions, including page operations (creation, archiving, restoration, searching), block operations (retrieval, appending, updating, deleting), and batch operations for efficient content management.

Notion MCP 서버

Notion MCP 서버는 AI 어시스턴트가 Notion API와 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 프로덕션 지원 서버는 자연어 상호 작용을 통해 Notion 콘텐츠를 읽고, 생성하고, 수정하기 위한 완전한 도구와 엔드포인트 세트를 제공합니다.

🚧 활발한 개발 : 데이터베이스 지원이 시작되었습니다! 댓글과 사용자 관리 도구가 추가되었습니다. 이 프로젝트가 유용하다고 생각되시면 별점을 남겨주세요. 이 작업이 커뮤니티에 가치 있다는 것을 알게 되고, 더 발전하는 데 동기를 부여합니다.

🚀 시작하기 및 통합

설정 프로세스

Notion API 키 얻기
- Notion Developers 에서 통합을 생성하세요
- API 키를 복사하세요
페이지에 대한 통합 활성화
- 기존 페이지를 선택하거나 Notion에서 새 페이지를 만드세요
- 오른쪽 상단의 "..." 메뉴를 클릭하세요
- "연결"로 이동
- 목록에서 통합을 찾아 활성화하세요
통합 방법을 선택하세요
- 선호하는 MCP 클라이언트에 따라 아래 통합 옵션 중 하나를 따르세요.
AI 비서에게 Notion과의 상호 작용을 요청하세요
- "오늘의 할 일로 새 페이지를 만들어 보세요"
- "Notion에서 회의 노트 업데이트"
- "회의록 페이지에 요점 추가"
- "프로젝트 추적을 위한 새로운 데이터베이스 생성"
- "내 작업 데이터베이스에 새 항목을 추가합니다"
- "내 프로젝트 페이지에 댓글을 추가하세요"
- "이 문서에 대한 모든 주석을 보여주세요"
- "내 작업 공간에 있는 모든 사용자 나열"
- "특정 사용자에 대한 정보를 얻으세요"

커서 통합

방법 1: mcp.json 사용

프로젝트 디렉토리에서 .cursor/mcp.json 파일을 만들거나 편집하세요.

지엑스피1

YOUR_KEY 및 YOUR_PAGE_ID 실제 Notion API 키 및 페이지 ID로 바꾸세요.
변경 사항을 적용하려면 커서를 다시 시작하세요.

방법 2: 수동 모드

커서를 열고 설정으로 이동하세요
"MCP" 또는 "모델 컨텍스트 프로토콜" 섹션으로 이동합니다.
"서버 추가" 또는 이와 동등한 것을 클릭하세요.
해당 필드에 다음 명령을 입력하세요.

env NOTION_TOKEN=YOUR_KEY NOTION_PAGE_ID=YOUR_PAGE_ID npx -y notion-mcp-server

YOUR_KEY 및 YOUR_PAGE_ID 실제 Notion API 키 및 페이지 ID로 바꾸세요.
설정을 저장하고 필요한 경우 커서를 다시 시작하세요.

Claude 데스크톱 통합

구성 디렉토리에서 mcp.json 파일을 만들거나 편집하세요.

{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "npx",
      "args": ["-y", "notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "YOUR_KEY",
        "NOTION_PAGE_ID": "YOUR_PAGE_ID"
      }
    }
  }
}

YOUR_KEY 및 YOUR_PAGE_ID 실제 Notion API 키 및 페이지 ID로 바꾸세요.
변경 사항을 적용하려면 Claude Desktop을 다시 시작하세요.

🌟 특징

📝 Notion 통합 - Notion 데이터베이스, 페이지 및 블록과 상호 작용
🔌 범용 MCP 호환성 - Cursor, Claude Desktop, Cline, Zed를 포함한 모든 MCP 클라이언트와 호환됩니다.
🔍 데이터 검색 - Notion 페이지, 블록 및 데이터베이스에서 정보 가져오기
✏️ 콘텐츠 생성 - Notion 페이지와 블록을 생성하고 업데이트합니다.
📊 블록 관리 - Notion 페이지 내에서 블록을 추가, 업데이트 및 삭제합니다.
💾 데이터베이스 작업 - 데이터베이스 생성, 쿼리 및 업데이트
🔄 일괄 작업 - 단일 요청으로 여러 작업 수행
🗑️ 보관 및 복원 - Notion 페이지 보관 및 복원
🔎 검색 기능 - 제목으로 Notion 페이지 및 데이터베이스 검색
💬 댓글 관리 - 페이지 및 토론에서 댓글을 받고, 작성하고, 답변하세요.
👥 사용자 관리 - 작업 공간 사용자 및 사용자 정보 검색

📚 문서

사용 가능한 도구

서버는 Notion과 상호 작용하기 위한 다음과 같은 통합 도구를 제공합니다.

`notion_pages`

다음을 포함한 페이지 작업을 위한 포괄적인 도구:

지정된 콘텐츠로 새 페이지 만들기
페이지 속성 업데이트
페이지 보관(휴지통으로 이동)
이전에 보관된 페이지 복원
제목으로 페이지 검색

예제 작업:

{
  "payload": {
    "action": "create_page", // One of: "create_page", "archive_page", "restore_page", "search_pages", "update_page_properties"
    "params": {
      // Parameters specific to the chosen action
    }
  }
}

`notion_blocks`

다음을 포함한 블록 작업을 위한 완벽한 툴킷:

블록 콘텐츠 검색
자식 블록 가져오기
부모에 새 블록 추가
기존 블록 업데이트
블록 삭제
일괄 작업 수행(추가, 업데이트, 삭제, 혼합)

예제 작업:

{
  "payload": {
    "action": "append_block_children", // One of: "append_block_children", "retrieve_block", "retrieve_block_children", "update_block", "delete_block", "batch_append_block_children", "batch_update_blocks", "batch_delete_blocks", "batch_mixed_operations"
    "params": {
      // Parameters specific to the chosen action
    }
  }
}

`notion_database`

다음을 포함한 데이터베이스 상호작용을 위한 강력한 도구:

사용자 정의 속성을 사용하여 새 데이터베이스 만들기
필터 및 정렬을 사용하여 데이터베이스 쿼리
데이터베이스 구조 및 속성 업데이트

예제 작업:

{
  "payload": {
    "action": "create_database", // One of: "create_database", "query_database", "update_database"
    "params": {
      // Parameters specific to the chosen action
    }
  }
}

`notion_comments`

Notion 콘텐츠에 대한 댓글을 관리하는 도구:

페이지 및 블록에서 댓글 검색
페이지에 새로운 댓글 추가
기존 토론에 답변하기

예제 작업:

{
  "payload": {
    "action": "get_comments", // One of: "get_comments", "add_page_comment", "add_discussion_comment"
    "params": {
      // Parameters specific to the chosen action
    }
  }
}

`notion_users`

사용자 정보에 접근하기 위한 도구:

모든 작업 공간 사용자 나열
특정 사용자에 대한 세부 정보 얻기
현재 봇 사용자에 대한 정보 검색

예제 작업:

{
  "payload": {
    "action": "list_users", // One of: "list_users", "get_user", "get_bot_user"
    "params": {
      // Parameters specific to the chosen action
    }
  }
}

사용 가능한 리소스

현재 서버는 어떠한 리소스도 공개하지 않고 대신 도구 기반 작업에 집중하고 있습니다.

🛠 개발

저장소 복제
git clone https://github.com/awkoy/notion-mcp-server.git cd notion-mcp-server
종속성 설치
npm install
환경 변수 설정
- 다음을 사용하여 .env 파일을 만듭니다.
  NOTION_TOKEN=your_notion_api_key NOTION_PAGE_ID=your_notion_page_id
프로젝트 빌드
npm run build
검사기 실행
npm run inspector

🔧 기술 세부 사항

TypeScript 및 MCP SDK(버전 1.7.0+)를 사용하여 빌드됨
공식 Notion API 클라이언트(@notionhq/client v2.3.0+)를 사용합니다.
모델 컨텍스트 프로토콜 사양을 따릅니다.
Notion 페이지, 블록 및 데이터베이스에서 CRUD 작업을 위한 도구를 구현합니다.
성능 최적화를 위한 효율적인 일괄 작업 지원
Zod 스키마를 사용하여 입력/출력을 검증합니다.

❓ 문제 해결

일반적인 문제
- 인증 오류 : Notion 토큰에 올바른 권한이 있는지 확인하고 페이지/데이터베이스에 대한 통합이 활성화되어 있는지 확인하세요.
- 페이지 액세스 문제 : 액세스하려는 페이지에 통합이 추가되었는지 확인하세요.
- 속도 제한 : Notion API에는 속도 제한이 있습니다. 일괄 작업을 사용하여 요청을 최적화하세요.
도움 받기
- GitHub 저장소 에 이슈를 생성하세요
- Notion API 문서를 확인하세요
- 도움이 필요하면 MCP 커뮤니티 채널을 방문하세요.