Notion 통합을 위한 모델 컨텍스트 프로토콜(MCP) 서버 구현으로, Notion API와 상호작용할 표준화된 인터페이스를 제공합니다. Claude Desktop 및 기타 MCP 클라이언트와 호환됩니다.

특징

• 목록 및 쿼리 노션 데이터베이스
• 페이지 생성 및 업데이트
• Notion 작업 공간 전체 검색
• 데이터베이스 정보 수집 및 어린이 차단
• httpx를 통한 완전한 비동기/대기 지원
• Pydantic v2 모델에서 타입 안전
• 상세한 로깅을 통한 적절한 오류 처리
• MCP 1.6.0과의 호환성

설치

Smithery를 통해 설치 중

Smithery를 통해 Claude 데스크톱용 Notion 통합 서버를 자동으로 설치하려면:

수동 설치

1. 저장소 복제:

2. 가상 환경 생성 및 의존성 설치 (uv 사용):

또는 표준 venv를 사용하면:

3. 프로젝트 루트에 .env 파일을 생성합니다:

사용

1. 서버 테스트 (오류 없이 실행됨):

2. Claude Desktop에서 사용하려면 macOS에서 [~/Library/Application Support/Claude/claude_desktop_config.json에 위치한 claude_desktop_config.json 파일을 조정하세요:

/Users/username/를 실제 홈 디렉터리 경로로 교체하는 것을 잊지 마세요.

개발

프로젝트 구조

Notion MCP Server

A Model Context Protocol (MCP) server implementation for Notion integration, providing a standardized interface for interacting with Notion’s API. Compatible with Claude Desktop and other MCP clients.

Features

• List and query Notion databases
• Create and update pages
• Search across Notion workspace
• Get database details and block children
• Full async/await support with httpx
• Type-safe with Pydantic v2 models
• Proper error handling with detailed logging
• Compatibility with MCP 1.6.0

Installation

Installing via Smithery

To install Notion Integration Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @ccabanillas/notion-mcp --client claude

Manual Installation

1. Clone the repository:

git clone https://github.com/ccabanillas/notion-mcp.git
cd notion-mcp

2. Create a virtual environment and install dependencies (using uv):

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

Alternatively, using standard venv:

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

3. Create a .env file in the project root:

NOTION_API_KEY=your_notion_integration_token

Usage

1. Test the server (it should run without errors):

python -m notion_mcp

2. To use it with Claude Desktop, adjust your claude_desktop_config.json file (located at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "servers": {
    "notion-mcp": {
      "command": "/Users/username/Projects/notion-mcp/.venv/bin/python",
      "args": ["-m", "notion_mcp"],
      "cwd": "/Users/username/Projects/notion-mcp"
    }
  }
}

Be sure to replace /Users/username/ with your actual home directory path.

Development

Project Structure

notion-mcp/
├── src/
│   └── notion_mcp/
│       ├── models/
│       │   ├── __init__.py
│       │   └── notion.py      # Pydantic models for Notion objects
│       ├── __init__.py        
│       ├── __main__.py        # Entry point
│       ├── client.py          # Notion API client
│       └── server.py          # MCP server implementation
├── .env                       # Environment variables (add your Notion API key here)
├── .gitignore
├── pyproject.toml             # Project dependencies
└── README.md

Running Tests

pytest

Configuration

The server requires a Notion integration token. To set this up:

1. Go to https://www.notion.so/my-integrations
2. Create a new integration with appropriate capabilities (read/write as needed)
3. Copy the integration token
4. Add it to your .env file in the project root directory:

NOTION_API_KEY=your_notion_integration_token