Things 3 Extended

Servidor MCP Things 3 Extended - Extensión DXT

Una Extensión de Escritorio (DXT) integral para la integración de la gestión de tareas de Things 3 con capacidades mejoradas que incluyen movimiento de tareas, edición y funcionalidad de respaldo.

Características

📋 Operaciones de Visualización

• view_inbox - Ver todas las tareas en la bandeja de entrada de Things 3
• view_today - Ver todas las tareas programadas para hoy
• view_projects - Ver todos los proyectos en Things 3
• view_areas - Ver todas las áreas en Things 3

➕ Operaciones de Creación

• create_task - Crear nuevas tareas con metadatos completos (notas, fechas, etiquetas, listas de verificación)
• create_project - Crear nuevos proyectos con áreas y programación
• create_area - Crear nuevas áreas organizativas

🔄 Operaciones de Movimiento de Tareas

• move_task_to_inbox - Mover tareas de hoy/otras listas de vuelta a la bandeja de entrada
• move_task_to_today - Programar tareas de la bandeja de entrada para hoy
• move_task_to_project - Asignar tareas a proyectos específicos
• move_task_to_area - Mover tareas a áreas específicas

✏️ Operaciones de Edición

• edit_task - Modificar propiedades de tareas existentes (título, notas, fechas, etiquetas)
• edit_project - Actualizar detalles y metadatos de proyectos

🔍 Operaciones de Gestión

• search_tasks - Buscar tareas por título o contenido
• complete_task - Marcar tareas como completadas

💾 Operaciones de Respaldo y Restauración

• backup_things3 - Crear respaldo integral de todos los datos de Things 3
• restore_things3 - Cargar datos de respaldo (análisis y referencia)

Instalación

Requisitos Previos

• macOS (requerido para Things 3)
• Aplicación Things 3 instalada
• Node.js 18.0.0 o superior
• Host compatible con DXT (Claude Desktop, etc.)

Instalar Dependencias

cd server
npm install

Empaquetar como Extensión DXT

Dado que la CLI de DXT aún no está disponible públicamente, cree el paquete manualmente:

# Create DXT package (ZIP format)
zip -r things3-mcp-dxt-extension-v1.0.0.dxt . -x "*.git*" "*.DS_Store*" "*.dxt" ".claude/*" "reddit_post.md"

Importante: Excluya el directorio .claude/ para evitar errores de instalación en Claude Desktop.

Agregar a la Aplicación Host

Agregue la extensión a la configuración de su host compatible con MCP:

{
  "mcpServers": {
    "things3-extended": {
      "command": "node",
      "args": ["/path/to/extension/server/index.js"]
    }
  }
}

Ejemplos de Uso

Flujo de Trabajo de Gestión de Tareas

// View what's in your inbox
await callTool("view_inbox");

// Create a new task
await callTool("create_task", {
  title: "Review quarterly reports",
  notes: "Focus on sales and marketing metrics",
  when: "today",
  tags: "work,review"
});

// Move task from today to a specific project
await callTool("move_task_to_project", {
  title: "Review quarterly reports", 
  project: "Q4 Planning"
});

// Edit the task to add a deadline
await callTool("edit_task", {
  current_title: "Review quarterly reports",
  deadline: "2024-12-31"
});

Respaldo y Recuperación

// Create backup
await callTool("backup_things3", {
  backup_path: "/Users/username/Desktop/things3_backup.json"
});

// Analyze backup contents
await callTool("restore_things3", {
  backup_path: "/Users/username/Desktop/things3_backup.json"
});

Implementación Técnica

Arquitectura

• Protocolo MCP: Utiliza @modelcontextprotocol/sdk para la comunicación
• Integración AppleScript: Interacción directa con Things 3 mediante AppleScript
• Esquemas de URL: Aprovecha los esquemas de URL de Things 3 para operaciones de creación
• Manejo de Errores: Gestión integral de tiempos de espera y errores

Características de Seguridad

• Saneamiento de entrada para prevención de inyección AppleScript
• Codificación de URL para caracteres especiales
• Protección de tiempo de espera (límite de 10 segundos)
• Escape seguro de cadenas

Consideraciones de Rendimiento

• Operaciones asíncronas en todo momento
• Ejecución eficiente de AppleScript
• Análisis JSON con valores predeterminados de respaldo
• Manejo de datos eficiente en memoria

Referencia de API

Parámetros de Creación de Tareas

{
  title: string,        // Required
  notes: string,        // Optional
  when: string,         // Optional - "today", "tomorrow", "2024-12-31"
  deadline: string,     // Optional - Date string
  tags: string,         // Optional - Comma-separated
  list: string,         // Optional - Project/area name
  checklist: string     // Optional - Checklist items
}

Estructura de Datos de Respaldo

{
  timestamp: "2024-12-01T10:00:00Z",
  version: "1.0.0",
  data: {
    inbox: [...],     // Array of inbox tasks
    today: [...],     // Array of today's tasks  
    projects: [...],  // Array of projects
    areas: [...]      // Array of areas
  }
}

Solución de Problemas

Problemas Comunes

1. "Things 3 no responde"

   • Asegúrese de que Things 3 esté ejecutándose
   • Verifique los permisos de macOS para AppleScript

2. Errores de "Tarea no encontrada"

   • La búsqueda utiliza coincidencia parcial
   • Verifique los títulos exactos de las tareas
   • Las tareas pueden estar en listas diferentes

3. Fallos de respaldo/restauración

   • Verifique los permisos de la ruta del archivo
   • Asegure suficiente espacio en disco
   • Verifique la sintaxis JSON en los archivos de respaldo

Modo de Depuración

Establezca NODE_ENV=development para registro detallado:

NODE_ENV=development node server/index.js

Licencia

Licencia MIT - Consulte el archivo LICENSE para más detalles.

Repositorio

GitHub: https://github.com/upup666/things3-mcp-dxt-extension

Contribuciones

¡Las contribuciones son bienvenidas! Por favor, siga el estilo de código existente y agregue pruebas para nuevas características.

Problemas y Soporte

Reporte problemas en: https://github.com/upup666/things3-mcp-dxt-extension/issues

---

🚀 ¡Listo para potenciar su flujo de trabajo de Things 3 con asistencia de IA!