Notion MCP

Integración de Notion MCP

Un servidor simple de Protocolo de Contexto de Modelo (MCP) que se integra con la API de Notion para gestionar mi lista de tareas personales a través de Claude. Se trata de una implementación básica diseñada específicamente para mi configuración minimalista de listas de tareas en Notion.

Nota importante

Este es un proyecto personal diseñado para un caso de uso muy específico: mi sencilla lista de tareas pendientes de Notion que tiene solo tres propiedades:

• Tarea (título)
• Cuándo (seleccione con sólo dos opciones: "hoy" o "más tarde")
• Casilla de verificación (marca si está completa)

Ejemplo de base de datos de Notion

Si bien puede usar esto como punto de partida para su propia integración de Notion, probablemente necesitará modificar el código para que coincida con la estructura y los requisitos específicos de su base de datos.

Características

• Agregar nuevos elementos de tareas pendientes
• Ver todos los todos
• Ver las tareas de hoy
• Marcar una tarea como completada

Prerrequisitos

• Python 3.10 o superior
• Una cuenta de Notion
• Una integración de Notion (clave API)
• Una base de datos de Notion que coincida exactamente con la estructura descrita anteriormente (o la voluntad de modificar el código para su estructura)

Configuración

1. Clonar el repositorio:

2. Configurar el entorno de Python:

3. Crear una integración de Notion:
   • Vaya a https://www.notion.so/my-integrations
   • Crear nueva integración
   • Copiar la clave API
4. Comparte tu base de datos con la integración:
   • Abra su base de datos de tareas pendientes en Notion
   • Haga clic en el menú "..." → "Agregar conexiones"
   • Seleccione su integración
5. Crea un archivo .env :

6. Configurar Claude Desktop:

Ejecución del servidor

El servidor se puede ejecutar de dos maneras:

1. Directamente desde la línea de comandos:

2. Automáticamente a través de Claude Desktop (recomendado):

• El servidor se iniciará cuando se inicie Claude si está configurado correctamente en claude_desktop_config.json
• No es necesaria la gestión manual del servidor
• El servidor se detiene cuando se cierra Claude

Nota: Cuando se ejecuta directamente, el servidor no mostrará ninguna salida a menos que haya un error; esto es normal ya que está esperando comandos MCP.

Uso

Comandos básicos a través de Claude:

• "Mostrar todas mis tareas pendientes"
• "¿Qué hay en mi lista para hoy?"
• Añade una tarea para hoy: revisar correos electrónicos.
• "Añadir una tarea para más tarde: revisar el proyecto"

Limitaciones

• Solo funciona con una estructura de base de datos de Notion específica
• No hay soporte para esquemas de bases de datos complejos
• Limitado a la programación de tareas "hoy" o "más tarde"
• No hay soporte para propiedades adicionales o campos personalizados
• Manejo básico de errores
• No hay funciones avanzadas como tareas recurrentes, prioridades o etiquetas

Personalización

Si desea utilizar esto con una estructura de base de datos diferente, deberá modificar el archivo server.py , particularmente:

• La función create_todo() para que coincida con las propiedades de su base de datos
• El formato de todo en call_tool() para manejar su estructura de datos
• El esquema de entrada en list_tools() si desea diferentes opciones

Estructura del proyecto

Licencia

Licencia MIT - Úselo bajo su propio riesgo

Expresiones de gratitud

• Creado para funcionar con Claude Desktop
• Utiliza la API de Notion