Notion MCP 통합

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

중요 참고 사항

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

• 작업(제목)

• 언제 (오늘 또는 나중에 두 가지 옵션만 선택)

• 체크박스 (완료 시 표시)

예제 Notion 데이터베이스

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

Related MCP server: Notion MCP Server

특징

• 새로운 할 일 항목 추가

• 모든 할 일 보기

• 오늘의 작업 보기

• 작업을 완료로 체크하세요

필수 조건

• Python 3.10 이상

• Notion 계정

• Notion 통합(API 키)

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

설정

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

지엑스피1

2. Python 환경 설정:

python -m venv .venv
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate
uv pip install -e .

3. Notion 통합을 만듭니다.

   • https://www.notion.so/my-integrations 로 이동하세요

   • 새로운 통합을 만듭니다

   • API 키를 복사하세요

4. 통합을 통해 데이터베이스를 공유하세요:

   • Notion에서 할 일 데이터베이스 열기

   • "..." 메뉴 → "연결 추가"를 클릭하세요.

   • 통합을 선택하세요

5. .env 파일을 만듭니다.

NOTION_API_KEY=your-api-key-here
NOTION_DATABASE_ID=your-database-id-here

6. Claude Desktop 구성:

{
  "mcpServers": {
    "notion-todo": {
      "command": "/path/to/your/.venv/bin/python",
      "args": ["-m", "notion_mcp"],
      "cwd": "/path/to/notion-mcp"
    }
  }
}

서버 실행

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

1. 명령줄에서 직접:

# From the project directory with virtual environment activated
python -m notion_mcp

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

• claude_desktop_config.json 에서 올바르게 구성된 경우 Claude가 시작되면 서버가 시작됩니다.

• 수동 서버 관리가 필요 없습니다

• Claude가 닫히면 서버가 중지됩니다.

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

용법

Claude를 통한 기본 명령:

• "내 모든 할 일 표시"

• "오늘 내 할 일은 뭐야?"

• "오늘 할 일 추가: 이메일 확인"

• "나중에 할 작업 추가: 프로젝트 검토"

제한 사항

• 특정 Notion 데이터베이스 구조에서만 작동합니다.

• 복잡한 데이터베이스 스키마에 대한 지원이 없습니다.

• "오늘" 또는 "나중" 작업 일정으로 제한됨

• 추가 속성이나 사용자 정의 필드에 대한 지원이 없습니다.

• 기본 오류 처리

• 반복 작업, 우선순위 또는 태그와 같은 고급 기능이 없습니다.

사용자 정의

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

• 데이터베이스 속성과 일치하도록 create_todo() 함수

• call_tool() 에서 데이터 구조를 처리하기 위한 todo 포맷팅

• 다른 옵션을 원하는 경우 list_tools() 의 입력 스키마

프로젝트 구조

notion_mcp/
├── pyproject.toml
├── README.md
├── .env                   # Not included in repo
└── src/
    └── notion_mcp/
        ├── __init__.py
        ├── __main__.py
        └── server.py      # Main implementation

특허

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

감사의 말

• Claude Desktop과 함께 작동하도록 제작됨

• Notion의 API를 사용합니다