Notion MCP 서버

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

특징

Notion 데이터베이스 나열 및 쿼리
페이지 생성 및 업데이트
Notion 작업 공간에서 검색
데이터베이스 세부 정보를 가져오고 자식을 차단합니다.
httpx를 통한 완전한 async/await 지원
Pydantic v2 모델을 사용한 유형 안전
자세한 로깅을 통한 적절한 오류 처리
MCP 1.6.0과의 호환성

설치

저장소를 복제합니다.

지엑스피1

가상 환경을 만들고 종속성을 설치합니다(uv 사용):

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

또는 표준 venv를 사용하면:

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

프로젝트 루트에 .env 파일을 만듭니다.

NOTION_API_KEY=your_notion_integration_token

용법

서버를 테스트합니다(오류 없이 실행되어야 함):

python -m notion_mcp

Claude Desktop과 함께 사용하려면 claude_desktop_config.json 파일(macOS에서는 ~/Library/Application Support/Claude/claude_desktop_config.json 에 위치)을 조정하세요.

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

/Users/username/ 실제 홈 디렉토리 경로로 바꿔야 합니다.

개발

프로젝트 구조

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

테스트 실행

pytest

구성

서버에는 Notion 통합 토큰이 필요합니다. 설정하려면 다음 단계를 따르세요.

https://www.notion.so/my-integrations 로 이동하세요
적절한 기능(필요에 따라 읽기/쓰기)을 사용하여 새로운 통합을 만듭니다.
통합 토큰을 복사하세요
프로젝트 루트 디렉토리의 .env 파일에 추가하세요.

NOTION_API_KEY=your_notion_integration_token

통합을 통해 Notion 데이터베이스를 공유하세요(데이터베이스의 "공유" 메뉴에서)

기여하다

저장소를 포크하세요
기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
브랜치에 푸시( git push origin feature/amazing-feature )
풀 리퀘스트 열기

특허

MIT 라이선스 - 사용 시 모든 책임은 사용자에게 있습니다.

문제 해결

일반적인 문제

연결 오류 : Notion API 키가 올바르고 인터넷에 접속할 수 있는지 확인하세요.
권한 오류 : 통합에 액세스하려는 데이터베이스에 대한 액세스 권한이 부여되었는지 확인하세요.
Claude Desktop 통합 : Claude Desktop이 연결되지 않으면 구성 경로가 올바른지, 서버가 stdout에 로그인하지 않고 실행 중인지 확인하세요.

감사의 말

Claude Desktop 및 기타 MCP 클라이언트와 함께 작동하도록 제작됨
Notion의 API를 사용합니다(최신 호환 버전 2022-02-22)
MCP 1.6.0 호환성 유지됨
danhilse 에게 특별히 감사드립니다. 저는 그의 notion-mcp-server 프로젝트를 참조했습니다.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Notion API와 상호 작용하기 위한 표준화된 인터페이스를 제공하는 모델 컨텍스트 프로토콜 서버로, 사용자가 데이터베이스를 나열하고, 페이지를 만들고, Notion 작업 공간에서 검색할 수 있도록 합니다.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Notion MCP
Badhansen
-
security
A
license
-
quality
A Model Context Protocol server that integrates with Notion's API to manage personal todo lists, allowing users to view, add, and update tasks directly from Claude.
Last updated -
13
Python
MIT License
Notion MCP Server
SAhmadUmass
-
security
F
license
-
quality
A Model Context Protocol server that enables Claude and other LLMs to interact with Notion workspaces, providing capabilities like searching, retrieving, creating and updating pages, as well as managing databases.
Last updated -
194
2
TypeScript
ConnectWise API Gateway MCP Server
jasondsmith72
-
security
F
license
-
quality
A Model Context Protocol server that provides a comprehensive interface for interacting with the ConnectWise Manage API, simplifying API discovery, execution, and management for both developers and AI assistants.
Last updated -
46
2
Python
Notion MCP Server
emmanuelsystems
A
security
F
license
A
quality
A Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.
Last updated -
12
194
JavaScript

View all related MCP servers

Notion MCP Server