MCP Notion Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides tools for interacting with Notion databases and pages, enabling CRUD operations on Notion content, querying databases with filters, managing page properties, and working with blocks. Also offers AI-powered tools for content analysis, summarization, and tag suggestion.

mcp-notion-server

Notion 통합을 위한 모델 컨텍스트 프로토콜 서버

이 TypeScript 기반 MCP 서버는 Claude와 Notion 간의 브릿지를 구현하여 Notion의 데이터베이스 및 페이지와 원활하게 상호 작용할 수 있도록 합니다. 다음을 통해 핵심 MCP 개념을 보여줍니다.

  • Notion 페이지 및 데이터베이스에 대한 리소스 관리
  • Notion 콘텐츠의 CRUD 작업을 위한 도구
  • 콘텐츠 분석을 위한 AI 기반 프롬프트

특징

자원

  • URI를 통해 Notion 페이지 및 데이터베이스에 액세스
  • 일반 텍스트 및 서식 있는 텍스트 콘텐츠 유형 지원
  • Notion 속성에서 메타데이터 추출

도구

데이터베이스 작업

  • list_databases - 접근 가능한 모든 Notion 데이터베이스 나열
  • create_database - 사용자 정의 속성을 사용하여 새 데이터베이스를 만듭니다.
  • query_database - 데이터베이스 항목 검색 및 필터링
  • update_database - 데이터베이스 속성 및 스키마 수정

페이지 작업

  • create_page - 데이터베이스 또는 하위 페이지에 새 페이지를 만듭니다.
    • 제목, 속성 및 마크다운 콘텐츠 지원
  • update_page - 기존 페이지 속성 업데이트
  • get_page - 페이지 콘텐츠 및 메타데이터 검색
  • delete_page - 데이터베이스 또는 부모 페이지에서 페이지 제거

블록 작업

  • append_blocks - 페이지에 새 블록 추가
  • delete_blocks - 페이지에서 블록 제거
  • get_blocks - 블록 콘텐츠 검색
  • update_blocks - 기존 블록 콘텐츠 수정

프롬프트

  • summarize_notes - 노트의 간결한 요약을 생성합니다.
  • analyze_content - 페이지 콘텐츠에 대한 통찰력과 분석 제공
  • suggest_tags - 콘텐츠에 따라 관련 태그를 추천합니다.

설정

필수 조건

  • Node.js 18 이상
  • Notion API 키 및 통합 설정
  • 클로드 데스크톱 애플리케이션

Claude Desktop과 통합

Notion 통합 만들기:

  1. Notion 통합 페이지를 방문하세요.
  2. "새로운 통합"을 클릭합니다.
  3. 통합의 이름을 지정하고 적절한 권한을 선택합니다(예: "콘텐츠 읽기", "콘텐츠 업데이트").
  4. 비밀 열쇠를 찾으세요:
  5. 통합에서 "내부 통합 토큰"을 복사하세요. 이 토큰은 인증에 사용됩니다.
  6. 작업 공간에 통합을 추가하세요:
  7. Notion에서 통합에 액세스하려는 페이지나 데이터베이스를 엽니다.
  8. 오른쪽 상단 모서리에 있는 탐색 버튼을 클릭하세요.
  9. "연결 대상" 버튼을 클릭하고 통합을 선택하세요.

구성 설정

Claude Desktop에 서버 구성을 추가합니다.

맥OS :

지엑스피1

윈도우 :

%APPDATA%/Claude/claude_desktop_config.json

구성 내용:

{ "mcpServers": { "mcp-notion-server": { "command": "npx", "args": [ "-y", "@gabornyerges/mcp-notion-server" ], "env": { "NOTION_API_KEY": "your-notion-api-key" } } } }

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 패키지 스크립트로 제공되는 MCP Inspector를 사용하는 것이 좋습니다.

  1. MCP 검사관
npm run inspector

MIT 라이선스 - 자세한 내용은 라이선스를 참조하세요.

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Claude AI와 Notion을 연결하는 브리지로, 사용자가 자연어로 Notion 데이터베이스 및 페이지와 상호 작용할 수 있도록 하여 콘텐츠 생성, 읽기, 업데이트, 삭제와 같은 작업을 지원합니다.

  1. Features
    1. Resources
    2. Tools
    3. Prompts
  2. Setup
    1. Prerequisites
  3. Integration with Claude Desktop
    1. Configuration Setup
    2. Debugging
ID: stxohtlgox