Servidor MCP de Things

Este servidor de Protocolo de Contexto de Modelo (MCP) te permite usar Claude Desktop para interactuar con tus datos de gestión de tareas en la app Things . Puedes pedirle a Claude que cree tareas, analice proyectos, te ayude a gestionar prioridades y mucho más.

Este servidor aprovecha la biblioteca Things.py y el esquema de URL de Things .

Características

• Acceso a todas las listas principales de cosas (Bandeja de entrada, Hoy, Próximos, etc.)
• Gestión de proyectos y áreas
• Operaciones de etiquetas
• Capacidades de búsqueda avanzada
• Seguimiento de artículos recientes
• Información detallada del artículo, incluidas listas de verificación
• Soporte para datos anidados (proyectos dentro de áreas, tareas pendientes dentro de proyectos)

Instalación (para Claude Desktop)

1. Prerrequisitos

• Python 3.12+
• Escritorio de Claude
• Cosas 3 ("Habilitar URL de Cosas" debe estar activado en Configuración -> General)

2. Instale uv si aún no lo ha hecho:

Luego reinicie su terminal.

3. Clonar este repositorio:

4. Instale los paquetes de Python necesarios:

5. Editar el archivo de configuración de Claude Desktop:

Agregue el servidor Things a la clave mcpServers al archivo de configuración (asegúrese de actualizar la ruta a la carpeta donde instaló estos archivos):

Reinicie la aplicación Claude Desktop.

Ejemplo de uso con Claude Desktop

• "¿Qué hay en mi lista de tareas para hoy?"
• "Crea una lista de cosas por hacer para preparar el equipaje para mis vacaciones en la playa la próxima semana. Incluye una lista de verificación para empacar".
• "Evalúa mis tareas actuales utilizando la matriz de Eisenhower".
• "Ayúdame a realizar una revisión semanal al estilo GTD usando Things".

Consejos

• Crea un proyecto en Claude con instrucciones personalizadas que expliquen cómo usar Things y organizar áreas, proyectos, etiquetas, etc. Dile a Claude qué información quieres que se incluya cuando cree una nueva tarea (por ejemplo, pedirle que incluya detalles relevantes en la descripción de la tarea podría ser útil).
• Intenta agregar otro servidor MCP que le dé a Claude acceso a tu calendario. Esto te permitirá pedirle que bloquee tiempo en tu calendario para tareas específicas, cree tareas a partir de próximos eventos del calendario (por ejemplo, prepararse para una reunión), etc.

Herramientas disponibles

Vistas de lista

• get-inbox - Obtener todos los archivos de la Bandeja de entrada
• get-today - Obtener las tareas pendientes que vencen hoy
• get-upcoming - Obtén tus próximas tareas pendientes
• get-anytime - Obtener tareas pendientes de la lista Anytime
• get-someday - Obtener tareas pendientes de la lista Someday
• get-logbook - Obtener tareas completadas
• get-trash - Obtener todos los archivos eliminados

Operaciones básicas

• get-todos - Obtener todos, opcionalmente filtrados por proyecto
• get-projects - Obtener todos los proyectos
• get-areas - Obtener todas las áreas

Operaciones de etiquetas

• get-tags - Obtener todas las etiquetas
• get-tagged-items - Obtener elementos con una etiqueta específica

Operaciones de búsqueda

• search-todos - Búsqueda simple por título/notas
• search-advanced - Búsqueda avanzada con múltiples filtros

Operaciones basadas en el tiempo

• get-recent - Obtener elementos creados recientemente

Parámetros de la herramienta

tareas pendientes

• project_uuid (opcional) - Filtrar tareas por proyecto
• include_items (opcional, valor predeterminado: verdadero): incluye elementos de la lista de verificación

obtener-proyectos / obtener-áreas / obtener-etiquetas

• include_items (opcional, predeterminado: falso): incluye elementos contenidos

búsqueda avanzada

• status - Filtrar por estado (incompleto/completado/cancelado)
• start_date - Filtrar por fecha de inicio (AAAA-MM-DD)
• deadline - Filtrar por fecha límite (AAAA-MM-DD)
• tag - Filtrar por etiqueta
• area - Filtrar por UUID de área
• type - Filtrar por tipo de elemento (tareas pendientes/proyecto/encabezado)

obtener reciente

• period - Período de tiempo (por ejemplo, '3d', '1s', '2m', '1y')

Solución de problemas

El servidor incluye gestión de errores para:

• UUID no válidos
• Faltan parámetros requeridos
• Errores de acceso a la base de datos de Things
• Errores de formato de datos

Todos los errores se registran y se devuelven con mensajes descriptivos. Para revisar los registros de MCP desde Claude Desktop, ejecute lo siguiente en la terminal: