Skip to main content
Glama
SystemPrompt MCP Notion Server

SystemPrompt MCP Notion Server

by Ejb503

시스템 프롬프트-mcp-개념

npm 버전 적용 상태 트위터 팔로우 불화 대장간 배지

웹사이트 | 문서

SystemPrompt MCP Notion 서버

Notion을 AI 워크플로에 완벽하게 통합하는 고성능 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 AI 에이전트가 표준화된 프로토콜을 통해 Notion 페이지 및 데이터베이스와 상호 작용할 수 있도록 지원합니다. 이 서버는 MCP 샘플링을 지원하며, MCP 샘플링은 Notion 페이지를 생성하고 업데이트하는 데 필수적입니다.

호환되는 MCP 클라이언트는 여기에서 다운로드할 수 있습니다.

서버 기능

지엑스피1

Related MCP server: Notion MCP Server

주요 특징

  • 📝 포괄적인 콘텐츠 관리

    • 서식 있는 텍스트로 페이지를 만들고 업데이트합니다.

    • Notion 작업 공간에서 검색

  • 🛠 개발자 친화적

    • Jest를 사용한 광범위한 테스트 범위

    • TypeScript 지원

    • 포괄적인 오류 처리

    • 자세한 로깅 및 디버깅 도구

필수 조건

이 서버를 사용하려면 다음이 필요합니다.

  1. Systemprompt API 키 (무료)

  2. Notion 계정 및 작업 공간

    • 활성화된 Notion 계정

    • 액세스하려는 콘텐츠가 있는 작업 공간

  3. Notion 통합

    • notion.so/my-integrations 에서 생성하세요

    • 필요한 기능:

      • 콘텐츠 읽기/업데이트/삽입

      • 데이터베이스 관리

      • 검색 기능

  4. MCP 호환 클라이언트

빠른 시작

  1. 설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 systemprompt-mcp-notion을 자동으로 설치하려면:

npx -y @smithery/cli install systemprompt-mcp-notion --client claude
npm install systemprompt-mcp-notion
  1. 구성 .env 파일을 만듭니다.

    SYSTEMPROMPT_API_KEY=your_systemprompt_api_key
    NOTION_API_KEY=your_notion_integration_token
  2. MCP 구성 MCP 구성 JSON에 다음을 추가합니다.

    {
      "mcpServers": {
        "notion": {
          "command": "npx",
          "args": ["systemprompt-mcp-notion"],
          "env": {
            "SYSTEMPROMPT_API_KEY": "your_systemprompt_api_key",
            "NOTION_API_KEY": "your_notion_integration_token"
          }
        }
      }
    }

    또는 패키지를 로컬로 설치한 경우:

    {
      "mcpServers": {
        "notion": {
          "command": "node",
          "args": ["./node_modules/systemprompt-mcp-notion/build/index.js"],
          "env": {
            "SYSTEMPROMPT_API_KEY": "your_systemprompt_api_key",
            "NOTION_API_KEY": "your_notion_integration_token"
          }
        }
      }
    }

개발

설정

  1. 저장소를 복제합니다.

    git clone https://github.com/systemprompt-io/systemprompt-mcp-notion.git
    cd systemprompt-mcp-notion
  2. 종속성 설치:

    npm install
  3. 환경 설정:

    cp .env.example .env
    # Edit .env with your API keys

테스트

Jest를 사용하여 높은 테스트 적용 범위를 유지합니다.

# Run all tests
npm test

# Watch mode for development
npm run test:watch

# Generate coverage report
npm run test:coverage

# Test Notion API connection
npm run test:notion

Available Tools

8 tools
systemprompt_create_notion_pageB

Creates a rich, comprehensive Notion page that expands upon basic user inputs. Takes simple instructions and content, then generates a detailed, well-structured page with appropriate sections, formatting, and supplementary content.

Inputs: databaseId (required), userInstructions (required).

systemprompt_delete_notion_pageA

Permanently deletes a specified Notion page and all its contents. This action cannot be undone, so use with caution.

Inputs: pageId (required).

systemprompt_get_notion_pageA

Retrieves comprehensive details of a specific Notion page, including its content, properties, and metadata. Returns the complete page structure and all nested content blocks.

Inputs: pageId (required).

systemprompt_list_notion_databasesA

Lists all accessible Notion databases in your workspace, sorted by last edited time. Returns key metadata including database title, schema, and last edited timestamp.

Inputs: maxResults.

systemprompt_list_notion_pagesA

Lists all accessible Notion pages in your workspace, sorted by last edited time. Returns key metadata including title, URL, and last edited timestamp.

Inputs: maxResults.

systemprompt_search_notion_pagesB

Performs a full-text search across all accessible Notion pages using the provided query. Searches through titles, content, and metadata to find relevant matches.

Inputs: query (required), maxResults.

systemprompt_search_notion_pages_by_titleA

Searches specifically for Notion pages with titles matching the provided query. Useful for finding exact or similar title matches when you know the page name.

Inputs: title (required), maxResults.

systemprompt_update_notion_pageB

Updates an existing Notion page with rich, comprehensive content based on user instructions. Takes simple inputs and transforms them into well-structured, detailed page content while preserving existing information. Can enhance, reorganize, or expand the current content while maintaining page integrity.

Inputs: pageId (required), userInstructions (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 8 tools

    Disambiguation4/5

    Most tools have distinct purposes, such as create, delete, get, list, and update for pages, and list for databases. However, there is some overlap between 'systemprompt_search_notion_pages' and 'systemprompt_search_notion_pages_by_title', as both handle page searches, which could cause confusion for an agent. The descriptions help clarify the difference, but the overlap is notable.

    Naming Consistency5/5

    All tool names follow a consistent 'systemprompt_verb_notion_noun' pattern, with verbs like create, delete, get, list, search, and update, and nouns like page, pages, or databases. This uniformity makes the tool set predictable and easy to navigate, with no deviations in naming style.

    Tool Count5/5

    With 8 tools, the server is well-scoped for managing Notion pages and databases, covering essential operations like CRUD for pages, listing resources, and searching. Each tool serves a clear purpose without redundancy, making the count appropriate for the domain.

    Completeness4/5

    The tool set provides comprehensive coverage for Notion page management, including create, read, update, delete, list, and search operations, and extends to databases with listing. A minor gap is the lack of tools for managing databases beyond listing, such as creating or updating them, but core workflows for pages are fully covered.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      An MCP server that enables natural language interaction with the Notion API, allowing users to search, comment, create pages, and access content within their Notion workspace.
      282,573 npm
      -
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server for Notion API with optimized token efficiency and full database property filtering, enabling AI assistants to manage pages, databases, and blocks.
      32
      20 npm
      1
      MIT