Servidor MCP de Notion

Implementación de servidor del Protocolo de Contexto de Modelo (MCP) para la integración con Notion, que proporciona una interfaz estandarizada para interactuar con la API de Notion. Compatible con Claude Desktop y otros clientes MCP.

Características

• Listar y consultar bases de datos de Notion

• Crear y actualizar páginas

• Buscar en el espacio de trabajo de Notion

• Obtener detalles de la base de datos y bloquear a los niños

• Soporte completo de async/await con httpx

• Tipo seguro con modelos Pydantic v2

• Manejo adecuado de errores con registro detallado

• Compatibilidad con MCP 1.6.0

Related MCP server: Notion MCP Server

Instalación

1. Clonar el repositorio:

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

2. Cree un entorno virtual e instale dependencias (usando uv):

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

Alternativamente, utilizando venv estándar:

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

3. Cree un archivo .env en la raíz del proyecto:

NOTION_API_KEY=your_notion_integration_token

Uso

1. Pruebe el servidor (debería funcionar sin errores):

python -m notion_mcp

2. Para usarlo con Claude Desktop, ajuste su archivo claude_desktop_config.json (ubicado en ~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

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

Asegúrese de reemplazar /Users/username/ con la ruta de su directorio de inicio real.

Desarrollo

Estructura del proyecto

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

Ejecución de pruebas

pytest

Configuración

El servidor requiere un token de integración de Notion. Para configurarlo:

1. Vaya a https://www.notion.so/my-integrations

2. Cree una nueva integración con capacidades adecuadas (lectura/escritura según sea necesario)

3. Copiar el token de integración

4. Agreguelo a su archivo .env en el directorio raíz del proyecto:

NOTION_API_KEY=your_notion_integration_token

5. Comparte tus bases de datos de Notion con la integración (desde el menú "Compartir" de la base de datos)

Contribuyendo

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

5. Abrir una solicitud de extracción

Licencia

Licencia MIT - Úselo bajo su propio riesgo

Solución de problemas

Problemas comunes

• Errores de conexión : asegúrese de que su clave API de Notion sea correcta y tenga acceso a Internet

• Errores de permisos : asegúrese de que su integración tenga acceso a las bases de datos a las que intenta acceder

• Integración de Claude Desktop : si Claude Desktop no se conecta, verifique que su ruta de configuración sea correcta y que el servidor se esté ejecutando sin iniciar sesión en stdout

Expresiones de gratitud

• Creado para funcionar con Claude Desktop y otros clientes MCP

• Utiliza la API de Notion (última versión compatible: 22/02/2022)

• Se mantiene la compatibilidad con MCP 1.6.0

• Un agradecimiento especial a danhilse , hice referencia a su proyecto notion-mcp-server.