Notion MCP

Notion MCP 통합

Notion API와 통합되어 Claude를 통해 제 개인 할 일 목록을 관리하는 간단한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이는 Notion에서 제가 사용하는 미니멀리스트 할 일 목록 설정에 맞춰 특별히 구현된 기본 구현입니다.

중요 참고 사항

이것은 매우 구체적인 사용 사례, 즉 세 가지 속성만 있는 간단한 Notion 할 일 목록을 위해 설계된 개인 프로젝트입니다.

• 작업(제목)
• 언제 (오늘 또는 나중에 두 가지 옵션만 선택)
• 체크박스 (완료 시 표시)

예제 Notion 데이터베이스

이를 Notion 통합의 시작점으로 사용할 수 있지만, 특정 데이터베이스 구조와 요구 사항에 맞게 코드를 수정해야 할 가능성이 높습니다.

특징

• 새로운 할 일 항목 추가
• 모든 할 일 보기
• 오늘의 작업 보기
• 작업을 완료로 체크하세요

필수 조건

• Python 3.10 이상
• Notion 계정
• Notion 통합(API 키)
• 위에 설명된 정확한 구조와 일치하는 Notion 데이터베이스(또는 귀하의 구조에 맞게 코드를 수정하려는 의지)

설정

1. 저장소를 복제합니다.

지엑스피1

2. Python 환경 설정:

3. Notion 통합을 만듭니다.
   • https://www.notion.so/my-integrations 로 이동하세요
   • 새로운 통합을 만듭니다
   • API 키를 복사하세요
4. 통합을 통해 데이터베이스를 공유하세요:
   • Notion에서 할 일 데이터베이스 열기
   • "..." 메뉴 → "연결 추가"를 클릭하세요.
   • 통합을 선택하세요
5. .env 파일을 만듭니다.

6. Claude Desktop 구성:

서버 실행

서버는 두 가지 방법으로 실행할 수 있습니다.

1. 명령줄에서 직접:

2. Claude Desktop을 통해 자동으로(권장):

• claude_desktop_config.json 에서 올바르게 구성된 경우 Claude가 시작되면 서버가 시작됩니다.
• 수동 서버 관리가 필요 없습니다
• Claude가 닫히면 서버가 중지됩니다.

참고: 직접 실행하는 경우 서버는 오류가 발생하지 않는 한 아무런 출력도 표시하지 않습니다. 이는 MCP 명령을 기다리는 중이므로 정상적인 현상입니다.

용법

Claude를 통한 기본 명령:

• "내 모든 할 일 표시"
• "오늘 내 할 일은 뭐야?"
• "오늘 할 일 추가: 이메일 확인"
• "나중에 할 작업 추가: 프로젝트 검토"

제한 사항

• 특정 Notion 데이터베이스 구조에서만 작동합니다.
• 복잡한 데이터베이스 스키마에 대한 지원이 없습니다.
• "오늘" 또는 "나중" 작업 일정으로 제한됨
• 추가 속성이나 사용자 정의 필드에 대한 지원이 없습니다.
• 기본 오류 처리
• 반복 작업, 우선순위 또는 태그와 같은 고급 기능이 없습니다.

사용자 정의

다른 데이터베이스 구조와 함께 사용하려면 server.py 파일을 수정해야 합니다. 특히 다음과 같은 부분이 수정되어야 합니다.

• 데이터베이스 속성과 일치하도록 create_todo() 함수
• call_tool() 에서 데이터 구조를 처리하기 위한 todo 포맷팅
• 다른 옵션을 원하는 경우 list_tools() 의 입력 스키마

프로젝트 구조

특허

MIT 라이선스 - 사용 시 모든 책임은 사용자에게 있습니다.

감사의 말

• Claude Desktop과 함께 작동하도록 제작됨
• Notion의 API를 사용합니다