Skip to main content
Glama
SystemPrompt MCP Notion Server

SystemPrompt MCP Notion Server

by Ejb503

noción del sistema-mcp-prompt

versión npm Estado de la cobertura Seguir en Twitter Discordia insignia de herrería

Sitio web | Documentación

Servidor de nociones del MCP del SystemPrompt

Un servidor de Protocolo de Contexto de Modelo (MCP) de alto rendimiento que integra Notion a la perfección en sus flujos de trabajo de IA. Este servidor permite a los agentes de IA interactuar con las páginas y bases de datos de Notion mediante un protocolo estandarizado. Este servidor admite y requiere el Muestreo de MCP, necesario para que el MCP cree y actualice páginas de Notion.

Un cliente MCP compatible está disponible aquí .

Capacidades del servidor

const serverCapabilities: { capabilities: ServerCapabilities } = {
  capabilities: {
    resources: {
      listChanged: true,
    },
    tools: {},
    prompts: {
      listChanged: true,
    },
    sampling: {},
  },
};

Related MCP server: Notion MCP Server

Características principales

  • 📝 Gestión integral de contenidos

    • Crear y actualizar páginas con formato de texto enriquecido

    • Busque en su espacio de trabajo de Notion

  • 🛠 Apto para desarrolladores

    • Amplia cobertura de pruebas con Jest

    • Compatibilidad con TypeScript

    • Manejo integral de errores

    • Herramientas detalladas de registro y depuración

Prerrequisitos

Antes de utilizar este servidor, necesitarás:

  1. Clave API de Systemprompt (gratuita)

  2. Cuenta y espacio de trabajo de Notion

    • Cuenta activa de Notion

    • Espacio de trabajo con contenido al que desea acceder

  3. Integración de nociones

    • Crear en notion.so/mis-integraciones

    • Capacidades requeridas:

      • Leer/Actualizar/Insertar contenido

      • Gestión de bases de datos

      • Funcionalidad de búsqueda

  4. Cliente compatible con MCP

Inicio rápido

  1. Instalación

Instalación mediante herrería

Para instalar systemprompt-mcp-notion para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install systemprompt-mcp-notion --client claude
npm install systemprompt-mcp-notion
  1. Configuración Cree un archivo .env :

    SYSTEMPROMPT_API_KEY=your_systemprompt_api_key
    NOTION_API_KEY=your_notion_integration_token
  2. Configuración de MCP Agregue lo siguiente a su JSON de configuración de MCP:

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

    Alternativamente, si ha instalado el paquete localmente:

    {
      "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"
          }
        }
      }
    }

Desarrollo

Configuración

  1. Clonar el repositorio:

    git clone https://github.com/systemprompt-io/systemprompt-mcp-notion.git
    cd systemprompt-mcp-notion
  2. Instalar dependencias:

    npm install
  3. Configurar el entorno:

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

Pruebas

Mantenemos una alta cobertura de pruebas utilizando 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