Notion API MCP

Notion API를 통해 고급 할 일 목록 관리 및 콘텐츠 구성 기능을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. MCP는 AI 모델이 외부 도구 및 서비스와 상호 작용할 수 있도록 지원하여 Notion의 강력한 기능과 원활하게 통합됩니다.

MCP 개요

AI 모델이 Notion API와 상호 작용할 수 있도록 하는 Python 기반 MCP 서버로, 다음을 제공합니다.

할 일 관리 : 서식 있는 텍스트, 마감일, 우선순위 및 중첩된 하위 작업을 사용하여 작업을 만들고, 업데이트하고, 추적합니다.
데이터베이스 작업 : 사용자 정의 속성, 필터 및 뷰를 사용하여 Notion 데이터베이스를 만들고 관리합니다.
콘텐츠 구성 : 마크다운 지원, 계층적 목록 및 블록 작업을 통해 콘텐츠 구조화 및 형식 지정
실시간 통합 : 깔끔한 비동기 구현을 통해 Notion의 작업 공간, 페이지 및 데이터베이스와 직접 상호 작용합니다.

전체 기능 목록 →

Related MCP server: Notion MCP

빠른 시작

지엑스피1

시작하기

1. Notion 통합 생성

https://www.notion.so/my-integrations 로 이동하세요
"새로운 통합"을 클릭하세요
통합 이름을 지정하세요(예: "내 MCP 통합")
통합을 사용할 작업 공간을 선택하세요
"내부 통합 토큰"을 복사하세요. 이것이 NOTION_API_KEY 가 됩니다.
- "ntn_"로 시작해야 합니다.

2. Notion Access 설정

새 데이터베이스를 생성하려면 부모 페이지나 기존 데이터베이스 ID가 필요합니다.

옵션 A: 새 데이터베이스의 부모 페이지

브라우저에서 Notion을 엽니다.
데이터베이스를 만들려는 새 페이지를 만들거나 기존 페이지를 엽니다.
오른쪽 상단의 ••• 메뉴를 클릭하세요
"연결 추가"를 선택하고 통합을 선택하세요
URL에서 페이지 ID를 복사합니다. 이는 마지막 슬래시 뒤와 물음표 앞의 문자열입니다.
- 예: https://notion.so/myworkspace/123456abcdef... 에서 ID는 123456abcdef... 입니다.
- 이것이 당신의 NOTION_PARENT_PAGE_ID 가 될 것입니다

옵션 B: 기존 데이터베이스

기존 Notion 데이터베이스를 엽니다.
통합에 연결되었는지 확인하세요(••• 메뉴 > 연결 추가)
URL에서 데이터베이스 ID를 복사합니다.
- 예: https://notion.so/myworkspace/123456abcdef...?v=... 에서 ID는 123456abcdef... 입니다.
- 이것이 당신의 NOTION_DATABASE_ID 가 될 것입니다

3. MCP 서버 설치

가상 환경 생성:

cd notion-api-mcp uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate

종속성 설치:

uv pip install -e .

환경 구성:

cp .env.integration.template .env

Notion 자격 증명으로 .env를 편집하세요.

NOTION_API_KEY=ntn_your_integration_token_here # Choose one or both of these depending on your needs: NOTION_PARENT_PAGE_ID=your_page_id_here # For creating new databases NOTION_DATABASE_ID=your_database_id_here # For working with existing databases

4. Claude Desktop 구성

중요: 서버는 .env 파일과 환경 변수를 모두 지원하지만, Claude Desktop은 MCP를 사용하려면 특별히 해당 구성 파일에서 구성이 필요합니다.

Claude Desktop의 구성( ~/Library/Application Support/Claude/claude_desktop_config.json )에 다음을 추가합니다.

{ "mcpServers": { "notion-api": { "command": "/path/to/your/.venv/bin/python", "args": ["-m", "notion_api_mcp"], "env": { "NOTION_API_KEY": "ntn_your_integration_token_here", // Choose one or both: "NOTION_PARENT_PAGE_ID": "your_page_id_here", "NOTION_DATABASE_ID": "your_database_id_here" } } } }

참고: .env 파일을 구성했더라도 Claude가 MCP를 사용하려면 Claude Desktop 구성에 다음 환경 변수를 추가해야 합니다. .env 파일은 주로 로컬 개발 및 테스트용으로 사용됩니다.

선적 서류 비치

구성 세부 정보 - 자세한 구성 옵션 및 환경 변수
기능 - 전체 기능 목록 및 성능
아키텍처 - 사용 가능한 도구 및 사용 예 개요
API 참조 - 자세한 API 엔드포인트 및 구현 세부 정보
테스트 커버리지 매트릭스 - 테스트 커버리지 및 검증 상태
종속성 - 프로젝트 종속성 및 버전 정보
변경 사항 - 개발 진행 상황 및 업데이트

개발

서버는 전반적으로 최신 Python 비동기 기능을 사용합니다.

Pydantic 모델을 사용한 유형 안전 구성
더 나은 성능을 위해 httpx를 사용한 비동기 HTTP
Notion 기능을 노출하기 위한 깔끔한 MCP 통합
적절한 리소스 정리 및 오류 처리

디버깅

서버에는 포괄적인 로깅이 포함되어 있습니다.

개발을 위한 콘솔 출력
서비스로 실행할 때 파일 로깅
자세한 오류 메시지
디버그 수준에서 요청/응답 로깅

직접 실행할 때 프로젝트 루트를 포함하도록 PYTHONPATH 설정합니다.

PYTHONPATH=/path/to/project python -m notion_api_mcp

미래 개발

계획된 개선 사항:

성능 최적화
- 요청 캐싱 추가
- 데이터베이스 쿼리 최적화
- 연결 풀링 구현
고급 기능
- 다중 작업 공간 지원
- 일괄 작업
- 실시간 업데이트
- 고급 검색 기능
개발자 경험
- 대화형 API 문서
- 일반적인 작업을 위한 CLI 도구
- 추가 코드 예제
- 성능 모니터링
테스트 개선 사항
- 성능 벤치마크
- 부하 테스트
- 추가적인 예외 사례
- 확장된 통합 테스트

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Reddit Discussion

Related Servers

Notion API MCP Server