Notion-MCP

[](https://www.npmjs.com/package/@devheerim/notion-mcp-server) [](https://opensource.org/licenses/MIT)

Notion 공식 API를 래핑한 MCP(Model Context Protocol) 서버입니다. 기본 제공되는 Notion MCP를 대체하며, 데이터베이스 쿼리 기능이 훨씬 더 강력합니다.

• `query_database`: 필터, 정렬, 페이지네이션을 완벽하게 지원하는 데이터베이스 쿼리
• 프로퍼티 기반 필터링: 복잡한 AND/OR 조건으로 정밀한 데이터 조회
• 전체 12개 도구: 페이지 CRUD, 댓글, 사용자 관리 등 포괄적인 기능

npm install -g @devheerim/notion-mcp-server

1. Notion Integrations에서 새 통합 생성
2. 생성된 Internal Integration Secret 복사 (ntn_ 으로 시작)

접근할 페이지/데이터베이스마다:

1. 우측 상단 ... > 연결 클릭
2. 생성한 Integration 선택

claude_desktop_config.json 또는 ~/.claude/settings.json에 추가:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@devheerim/notion-mcp-server"],
      "env": {
        "NOTION_API_KEY": "ntn_your_token_here"
      }
    }
  }
}

NOTION_API_KEY=ntn_your_token_here notion-mcp-server

| 도구 | 설명 | |------|------| | query_database | 데이터베이스를 필터, 정렬, 페이지네이션으로 쿼리 | | fetch_page | 페이지 상세 정보 및 블록 콘텐츠 조회 | | search | 워크스페이스 전체 검색 | | create_page | 새 페이지 생성 | | update_page | 기존 페이지 수정 | | create_database | 새 데이터베이스 생성 | | update_database | 데이터베이스 스키마 및 속성 수정 | | create_comment | 페이지에 댓글 추가 | | get_comments | 페이지의 모든 댓글 조회 | | get_users | 워크스페이스 사용자 조회 | | move_pages | 페이지를 다른 위치로 이동 | | duplicate_page | 기존 페이지 복제 |

query_database:
  database_id: "12345678901234567890123456789012"
  filter:
    property: "Status"
    select:
      equals: "완료"

query_database:
  database_id: "123456789