What is Mcp Notion

MCP-Notion is a Model Context Protocol (MCP) server that facilitates direct interaction between language models, such as Claude, and the Notion API. It acts as a standardized interface, removing the need for intermediary layers like Supabase.

Use cases

Use cases for MCP-Notion include executing simple searches within Notion, retrieving specific pages and their content, and querying databases for structured data management.

How to use

To use MCP-Notion, clone the repository, set up environment variables including your Notion API token, and then build and run the server. You can interact with the server via HTTP endpoints for searching, retrieving pages, and querying databases.

Key features

Key features of MCP-Notion include Notion search capabilities, page retrieval, database querying, CORS support, robust error handling, and integrated logging.

Where to use

MCP-Notion can be used in various fields where integration with Notion is required, such as project management, note-taking applications, and data organization tools.

MCP Notion

Servidor MCP (Model Context Protocol) para integración con Notion API. Proporciona endpoints HTTP para interactuar con bases de datos y páginas de Notion.

🚀 Características

• Búsqueda en Notion
• Obtención de páginas y contenido
• Consulta de bases de datos
• Soporte para CORS
• Manejo de errores robusto
• Logging integrado

📋 Requisitos Previos

• Rust (última versión estable)
• Token de API de Notion
• Base de datos o páginas en Notion para interactuar

🔧 Instalación

1. Clonar el repositorio:

git clone https://github.com/GsusFC/MCP-Notion.git
cd MCP-Notion

2. Configurar variables de entorno:

cp .env.example .env
# Editar .env y añadir tu NOTION_API_KEY

3. Compilar y ejecutar:

cargo build
cargo run

El servidor se iniciará en http://localhost:3004 por defecto.

🔌 API Endpoints

Búsqueda

POST /api/search
Content-Type: application/json

{
    "query": "término de búsqueda",
    "limit": 10
}

Obtener Página

GET /api/get_page/{page_id}

Obtener Contenido de Página

GET /api/get_page_content/{page_id}

Consultar Base de Datos

POST /api/query_database
Content-Type: application/json

{
    "database_id": "tu-database-id",
    "page_size": 100
}

⚙️ Configuración

Variables de entorno disponibles:

• NOTION_API_KEY: Token de API de Notion (requerido)
• MCP_PORT: Puerto del servidor (default: 3004)
• RUST_LOG: Nivel de logging (default: info)

🔍 Ejemplos de Uso

Búsqueda Simple

curl -X POST http://localhost:3004/api/search \
  -H "Content-Type: application/json" \
  -d '{"query": "", "limit": 5}'

Consultar Base de Datos

curl -X POST http://localhost:3004/api/query_database \
  -H "Content-Type: application/json" \
  -d '{"database_id": "tu-database-id", "page_size": 10}'

🤝 Contribuir

1. Fork el proyecto
2. Crear una rama para tu feature (git checkout -b feature/AmazingFeature)
3. Commit tus cambios (git commit -m 'Add some AmazingFeature')
4. Push a la rama (git push origin feature/AmazingFeature)
5. Abrir un Pull Request

📝 Licencia

Este proyecto está bajo la Licencia MIT - ver el archivo LICENSE para más detalles.

✨ Agradecimientos

• Equipo de Notion por su excelente API
• Comunidad de Rust por las herramientas y librerías