Skip to main content
Glama
enesjakozh

notion-mcp-server

by awkoy
OverviewInspectSchemaRelated ServersScoreDiscussions
TypeScript
Remote
MIT License
184
139

Notion MCP 서버

특허타입스크립트모델 컨텍스트 프로토콜 대장간 배지 NPM 다운로드별

Notion MCP 서버는 AI 어시스턴트가 Notion API와 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 프로덕션 지원 서버는 자연어 상호 작용을 통해 Notion 콘텐츠를 읽고, 생성하고, 수정하기 위한 완전한 도구와 엔드포인트 세트를 제공합니다.

🚧 활발한 개발 : 데이터베이스 지원이 시작되었습니다! 댓글과 사용자 관리 도구가 추가되었습니다. 이 프로젝트가 유용하다고 생각되시면 별점을 남겨주세요. 이 작업이 커뮤니티에 가치 있다는 것을 알게 되고, 더 발전하는 데 동기를 부여합니다.

📑 목차

Related MCP server: SystemPrompt MCP Notion Server

🚀 시작하기 및 통합

설정 프로세스

  1. Notion API 키 얻기

  2. 페이지에 대한 통합 활성화

    • 기존 페이지를 선택하거나 Notion에서 새 페이지를 만드세요

    • 오른쪽 상단의 "..." 메뉴를 클릭하세요

    • "연결"로 이동

    • 목록에서 통합을 찾아 활성화하세요Notion 페이지 연결

  3. 통합 방법을 선택하세요

    • 선호하는 MCP 클라이언트에 따라 아래 통합 옵션 중 하나를 따르세요.

  4. AI 비서에게 Notion과의 상호 작용을 요청하세요

    • "오늘의 할 일로 새 페이지를 만들어 보세요"

    • "Notion에서 회의 노트 업데이트"

    • "회의록 페이지에 요점 추가"

    • "프로젝트 추적을 위한 새로운 데이터베이스 생성"

    • "내 작업 데이터베이스에 새 항목을 추가합니다"

    • "내 프로젝트 페이지에 댓글을 추가하세요"

    • "이 문서에 대한 모든 주석을 보여주세요"

    • "내 작업 공간에 있는 모든 사용자 나열"

    • "특정 사용자에 대한 정보를 얻으세요"

커서 통합

방법 1: mcp.json 사용

  1. 프로젝트 디렉토리에서 .cursor/mcp.json 파일을 만들거나 편집하세요.

지엑스피1

  1. YOUR_KEY 및 YOUR_PAGE_ID 실제 Notion API 키 및 페이지 ID로 바꾸세요.

  2. 변경 사항을 적용하려면 커서를 다시 시작하세요.

방법 2: 수동 모드

  1. 커서를 열고 설정으로 이동하세요

  2. "MCP" 또는 "모델 컨텍스트 프로토콜" 섹션으로 이동합니다.

  3. "서버 추가" 또는 이와 동등한 것을 클릭하세요.

  4. 해당 필드에 다음 명령을 입력하세요.

env NOTION_TOKEN=YOUR_KEY NOTION_PAGE_ID=YOUR_PAGE_ID npx -y notion-mcp-server

  1. YOUR_KEY 및 YOUR_PAGE_ID 실제 Notion API 키 및 페이지 ID로 바꾸세요.

  2. 설정을 저장하고 필요한 경우 커서를 다시 시작하세요.

Claude 데스크톱 통합

  1. 구성 디렉토리에서 mcp.json 파일을 만들거나 편집하세요.

{ "mcpServers": { "notion-mcp-server": { "command": "npx", "args": ["-y", "notion-mcp-server"], "env": { "NOTION_TOKEN": "YOUR_KEY", "NOTION_PAGE_ID": "YOUR_PAGE_ID" } } } }

  1. YOUR_KEY 및 YOUR_PAGE_ID 실제 Notion API 키 및 페이지 ID로 바꾸세요.

  2. 변경 사항을 적용하려면 Claude Desktop을 다시 시작하세요.

🌟 특징

  • 📝 Notion 통합 - Notion 데이터베이스, 페이지 및 블록과 상호 작용

  • 🔌 범용 MCP 호환성 - Cursor, Claude Desktop, Cline, Zed를 포함한 모든 MCP 클라이언트와 호환됩니다.

  • 🔍 데이터 검색 - Notion 페이지, 블록 및 데이터베이스에서 정보 가져오기

  • ✏️ 콘텐츠 생성 - Notion 페이지와 블록을 생성하고 업데이트합니다.

  • 📊 블록 관리 - Notion 페이지 내에서 블록을 추가, 업데이트 및 삭제합니다.

  • 💾 데이터베이스 작업 - 데이터베이스 생성, 쿼리 및 업데이트

  • 🔄 일괄 작업 - 단일 요청으로 여러 작업 수행

  • 🗑️ 보관 및 복원 - Notion 페이지 보관 및 복원

  • 🔎 검색 기능 - 제목으로 Notion 페이지 및 데이터베이스 검색

  • 💬 댓글 관리 - 페이지 및 토론에서 댓글을 받고, 작성하고, 답변하세요.

  • 👥 사용자 관리 - 작업 공간 사용자 및 사용자 정보 검색

📚 문서

사용 가능한 도구

서버는 Notion과 상호 작용하기 위한 다음과 같은 통합 도구를 제공합니다.

notion_pages

다음을 포함한 페이지 작업을 위한 포괄적인 도구:

  • 지정된 콘텐츠로 새 페이지 만들기

  • 페이지 속성 업데이트

  • 페이지 보관(휴지통으로 이동)

  • 이전에 보관된 페이지 복원

  • 제목으로 페이지 검색

예제 작업:

{ "payload": { "action": "create_page", // One of: "create_page", "archive_page", "restore_page", "search_pages", "update_page_properties" "params": { // Parameters specific to the chosen action } } }

notion_blocks

다음을 포함한 블록 작업을 위한 완벽한 툴킷:

  • 블록 콘텐츠 검색

  • 자식 블록 가져오기

  • 부모에 새 블록 추가

  • 기존 블록 업데이트

  • 블록 삭제

  • 일괄 작업 수행(추가, 업데이트, 삭제, 혼합)

예제 작업:

{ "payload": { "action": "append_block_children", // One of: "append_block_children", "retrieve_block", "retrieve_block_children", "update_block", "delete_block", "batch_append_block_children", "batch_update_blocks", "batch_delete_blocks", "batch_mixed_operations" "params": { // Parameters specific to the chosen action } } }

notion_database

다음을 포함한 데이터베이스 상호작용을 위한 강력한 도구:

  • 사용자 정의 속성을 사용하여 새 데이터베이스 만들기

  • 필터 및 정렬을 사용하여 데이터베이스 쿼리

  • 데이터베이스 구조 및 속성 업데이트

예제 작업:

{ "payload": { "action": "create_database", // One of: "create_database", "query_database", "update_database" "params": { // Parameters specific to the chosen action } } }

notion_comments

Notion 콘텐츠에 대한 댓글을 관리하는 도구:

  • 페이지 및 블록에서 댓글 검색

  • 페이지에 새로운 댓글 추가

  • 기존 토론에 답변하기

예제 작업:

{ "payload": { "action": "get_comments", // One of: "get_comments", "add_page_comment", "add_discussion_comment" "params": { // Parameters specific to the chosen action } } }

notion_users

사용자 정보에 접근하기 위한 도구:

  • 모든 작업 공간 사용자 나열

  • 특정 사용자에 대한 세부 정보 얻기

  • 현재 봇 사용자에 대한 정보 검색

예제 작업:

{ "payload": { "action": "list_users", // One of: "list_users", "get_user", "get_bot_user" "params": { // Parameters specific to the chosen action } } }

사용 가능한 리소스

현재 서버는 어떠한 리소스도 공개하지 않고 대신 도구 기반 작업에 집중하고 있습니다.

🛠 개발

  1. 저장소 복제

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

  2. 종속성 설치

    npm install

  3. 환경 변수 설정

    • 다음을 사용하여 .env 파일을 만듭니다.

      NOTION_TOKEN=your_notion_api_key NOTION_PAGE_ID=your_notion_page_id

  4. 프로젝트 빌드

    npm run build

  5. 검사기 실행

    npm run inspector

🔧 기술 세부 사항

  • TypeScript 및 MCP SDK(버전 1.7.0+)를 사용하여 빌드됨

  • 공식 Notion API 클라이언트(@notionhq/client v2.3.0+)를 사용합니다.

  • 모델 컨텍스트 프로토콜 사양을 따릅니다.

  • Notion 페이지, 블록 및 데이터베이스에서 CRUD 작업을 위한 도구를 구현합니다.

  • 성능 최적화를 위한 효율적인 일괄 작업 지원

  • Zod 스키마를 사용하여 입력/출력을 검증합니다.

❓ 문제 해결

  • 일반적인 문제

    • 인증 오류 : Notion 토큰에 올바른 권한이 있는지 확인하고 페이지/데이터베이스에 대한 통합이 활성화되어 있는지 확인하세요.

    • 페이지 액세스 문제 : 액세스하려는 페이지에 통합이 추가되었는지 확인하세요.

    • 속도 제한 : Notion API에는 속도 제한이 있습니다. 일괄 작업을 사용하여 요청을 최적화하세요.

  • 도움 받기

🤝 기여하기

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

  1. 저장소를 포크하세요

  2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )

  3. 변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )

  4. 브랜치에 푸시( git push origin feature/amazing-feature )

  5. 풀 리퀘스트 열기

📄 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

View all tools

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/awkoy/notion-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server