hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Allows to add new todo items, view all todos, view today's tasks, and check off tasks as complete in a Notion database through Claude

Notion MCP 통합

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

중요 참고 사항

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

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

예제 Notion 데이터베이스

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

특징

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

필수 조건

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

설정

저장소를 복제합니다.

지엑스피1

Python 환경 설정:

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

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

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

Claude Desktop 구성:

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

서버 실행

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

명령줄에서 직접:

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

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를 사용합니다

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Claude를 통해 내 개인 할 일 목록을 관리하기 위해 Notion API와 통합되는 간단한 MCP(Model Context Protocol) 서버입니다.