hybrid server

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

Integrations

Enables interaction with Notion workspaces, providing tools for searching, reading, creating and updating pages, managing comments, performing block-level operations, and working with databases including creating, querying, and updating database items with various property types.

Servidor MCP de Notion

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona una integración fluida con Notion. Este servidor permite que los modelos de lenguaje interactúen con su espacio de trabajo de Notion mediante herramientas estandarizadas para buscar, leer, crear y actualizar páginas y bases de datos.

🌟 Características principales

Operaciones de página

🔍 Busca en tu espacio de trabajo de Notion
📝 Crea nuevas páginas con contenido enriquecido en Markdown
📖 Leer el contenido de la página con un formato limpio
🔄 Actualizar páginas existentes
💬 Agregar y recuperar comentarios
🧱 Operaciones a nivel de bloque (actualizar, eliminar)

Compatibilidad mejorada con Markdown

Múltiples niveles de encabezado (H1-H3)
Bloques de código con soporte de idiomas
Elementos de tareas interactivos con estados de casilla de verificación
Citas en bloque con soporte para varias líneas
Divisores horizontales
Imágenes con subtítulos
Viñetas anidadas

Operaciones de base de datos

Crear y administrar bases de datos
Agregar y actualizar elementos de la base de datos
Consulta con filtros y ordenación
Soporte para varios tipos de propiedades:
- Título, Texto enriquecido, Número
- Seleccionar, selección múltiple
- Fecha, Casilla de verificación
- ¡Y más!

🚀 Primeros pasos

Prerrequisitos

Node.js (v16 o superior)
Clave API de Notion
Cliente compatible con MCP (por ejemplo, Claude Desktop)

Instalación

Clonar el repositorio:

git clone https://github.com/v-3/notion-server.git
cd notion-server

Instalar dependencias:

npm install

Configura tu entorno:

# Create .env file
echo "NOTION_API_KEY=your_notion_api_key_here" > .env

# Or export directly
export NOTION_API_KEY=your_notion_api_key_here

Construir el servidor:

npm run build

🔧 Configuración

Configuración del escritorio de Claude

Actualice su configuración de Claude Desktop ( claude_desktop_config.json ):

{
    "mcpServers": {
        "notion": {
            "command": "node",
            "args": ["/absolute/path/to/notion-server/build/index.js"],
            "env": {
                "NOTION_API_KEY": "your_notion_api_key_here"
            }
        }
    }
}

Reinicie Claude Desktop para aplicar los cambios

🛠️ Herramientas disponibles

Operaciones de página

// Search pages
{
    query: string // Search query
}

// Read page
{
    pageId: string // ID of the page to read
}

// Create page
{
    title?: string,      // Page title
    content?: string,    // Page content in markdown
    parentPageId: string // Parent page ID
    properties?: object  // For database items
}

// Update page
{
    pageId: string,   // Page ID to update
    content: string,  // New content
    type?: string    // Content type
}

Operaciones de base de datos

// Create database
{
    parentPageId: string,
    title: string,
    properties: object
}

// Query database
{
    databaseId: string,
    filter?: object,
    sort?: object
}

🔐 Configuración de Notion Access

Creando una integración

Visita Integraciones de Notion
Haga clic en "Nueva integración"
Configurar permisos:
- Contenido: Leer, Actualizar, Insertar
- Comentarios: Leer, Crear
- Información del usuario: Leer

Conectando páginas

Abre tu página de Notion
Haga clic en el menú "..." → "Conexiones"
Añade tu integración
Repita para otras páginas según sea necesario.

Ejemplos de uso

Creando una página

const result = await notion.create_page({
  parentPageId: "page_id",
  title: "My Page",
  content: "# Welcome\nThis is a test page."
});

Consultar una base de datos

const result = await notion.query_database({
  databaseId: "db_id",
  filter: {
    property: "Status",
    select: {
      equals: "In Progress"
    }
  }
});

🤝 Contribuyendo

¡Agradecemos sus contribuciones! Por favor:

Bifurcar el repositorio
Crear una rama de características
Enviar una solicitud de extracción

📜 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

🙏 Agradecimientos

Este proyecto ha sido mejorado significativamente por sweir1/notion-server , quien ha realizado las siguientes actualizaciones:

Compatibilidad mejorada con rebajas y más tipos de bloques
Operaciones de bases de datos integrales
Manejo de errores y depuración mejorados
Mejor manejo de propiedades para elementos de la base de datos
Formato de salida de página más limpio

Para utilizar la versión de sweir1, puedes clonar su repositorio:

git clone https://github.com/sweir1/notion-server.git

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Permite que los modelos de lenguaje interactúen con los espacios de trabajo de Notion a través de herramientas estandarizadas para buscar, leer, crear y actualizar páginas y bases de datos.

Related Resources

Reddit Discussion about this server

Notion MCP Server

Integrations

Servidor MCP de Notion

🌟 Características principales

Operaciones de página

Compatibilidad mejorada con Markdown

Operaciones de base de datos

🚀 Primeros pasos

Prerrequisitos

Instalación

🔧 Configuración

Configuración del escritorio de Claude

🛠️ Herramientas disponibles

Operaciones de página

Operaciones de base de datos

🔐 Configuración de Notion Access

Creando una integración

Conectando páginas

Ejemplos de uso

Creando una página

Consultar una base de datos

🤝 Contribuyendo

📜 Licencia

🙏 Agradecimientos

Related Resources

Appeared in Searches