Notion API용 AI 친화적 MCP 서버입니다. 에이전트가 Notion 작업 공간을 찾고, 읽고, 쿼리하며, 업데이트할 수 있도록 도와주며, 일상적인 AI 워크플로우에 맞게 응답을 간결하게 유지합니다.

이 서버는 Notion API 2026-03-11를 대상으로 하며, 현재의 데이터베이스/데이터 소스 모델을 사용합니다. MCP 도구, 프롬프트, 리소스, 구조화된 도구 결과, 그리고 인터랙티브 Notion 워크플로우를 위한 선택적 MCP 앱을 노출합니다.

하이라이트

• notion_find를 이용한 탐색 및 표적 발견.
• notion_read_page를 통한 안정적인 블록 ID로 압축 페이지 읽기.
• notion_inspect_data_source를 이용한 데이터 소스 스키마 검사.
• 스키마 인식 데이터 소스, 간단한 값으로 쿼리 및 항목 생성.
• 단락, 제목, 목록, 할 일, 인용문, 콜아웃, 코드 블록, 구분자, 안전한 마크다운 추가 기능을 위한 간단한 페이지 편집 도구
• 고급 블록, 페이지, 데이터베이스, 데이터 소스, 주석, 사용자 조작을 위한 Raw Notion API 도구.
• 선택적 MCP 앱: 데이터 소스 탐색기와 페이지 워크벤치.

퀵 스타트

이 서버를 Claude Desktop과 같은 MCP 호스트에 추가하세요:

설정을 저장한 후 MCP 호스트를 재시작하세요.

설정 가이드

1. Notion 통합 생성

Notion MCP Server

AI-friendly MCP server for the Notion API. It helps agents find, read, query, and update Notion workspaces while keeping responses compact enough for day-to-day AI workflows.

This server targets the Notion API 2026-03-11 and uses the current database/data source model. It exposes MCP tools, prompts, resources, structured tool results, and optional MCP Apps for interactive Notion workflows.

Highlights

• Search and target discovery with notion_find.
• Compact page reading with stable block IDs via notion_read_page.
• Data source schema inspection with notion_inspect_data_source.
• Schema-aware data source querying and item creation with simple values.
• Simple page editing tools for paragraphs, headings, lists, todos, quotes, callouts, code blocks, dividers, and safe Markdown append.
• Raw Notion API tools for advanced block, page, database, data source, comment, and user operations.
• Optional MCP Apps: Data Source Explorer and Page Workbench.

Quick Start

Add this server to an MCP host such as Claude Desktop:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@suekou/mcp-notion-server"],
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      }
    }
  }
}

Restart your MCP host after saving the configuration.

Setup Guide

1. Create a Notion integration

Open the Notion integrations dashboard, then create a new internal integration.

2. Configure capabilities

Grant only the capabilities you need:

• Read content: required for search, page reads, data source retrieval, and queries.
• Insert content: required for creating pages/items and appending blocks.
• Update content: required for updating pages, blocks, and data source schemas.
• Read comments / Insert comments: required only for comment tools.
• User information: required only when using user lookup tools.

For full functionality during setup, enable read, insert, and update content. Add comment or user capabilities only if you plan to use those tools.

3. Grant content access

Open the Content access tab for your integration, then select the pages or databases you want the MCP server to read or edit.

You can also grant access from the target Notion page or database: open the ... menu, choose Connections, then add your integration.

Notion only lets an integration access pages and databases that have been shared with it. A connection added to a page can also access that page’s children.

4. Copy the internal integration token

Copy the integration secret. This value becomes NOTION_API_TOKEN in your MCP host config.