Labsco
upup666 logo

Things 3 Extended

★ 3

from upup666

A desktop extension for the Things 3 task manager, providing advanced features like task movement, editing, and backups.

🔥🔥🔥✓ VerifiedFreeQuick setup
#automation#calendar#git#security#marketing

Things 3 Extended MCP Server - DXT Extension

A comprehensive Desktop Extension (DXT) for Things 3 task management integration with enhanced capabilities including task movement, editing, and backup functionality.

Features

📋 Viewing Operations

  • view_inbox - View all tasks in Things 3 inbox
  • view_today - View all tasks scheduled for today
  • view_projects - View all projects in Things 3
  • view_areas - View all areas in Things 3

➕ Creation Operations

  • create_task - Create new tasks with full metadata (notes, dates, tags, checklists)
  • create_project - Create new projects with areas and scheduling
  • create_area - Create new organizational areas

🔄 Task Movement Operations

  • move_task_to_inbox - Move tasks from today/other lists back to inbox
  • move_task_to_today - Schedule inbox tasks for today
  • move_task_to_project - Assign tasks to specific projects
  • move_task_to_area - Move tasks to specific areas

✏️ Editing Operations

  • edit_task - Modify existing task properties (title, notes, dates, tags)
  • edit_project - Update project details and metadata

🔍 Management Operations

  • search_tasks - Search tasks by title or content
  • complete_task - Mark tasks as completed

💾 Backup & Restore Operations

  • backup_things3 - Create comprehensive backup of all Things 3 data
  • restore_things3 - Load backup data (analysis and reference)

Technical Implementation

Architecture

  • MCP Protocol: Uses @modelcontextprotocol/sdk for communication
  • AppleScript Integration: Direct interaction with Things 3 via AppleScript
  • URL Schemes: Leverages Things 3 URL schemes for creation operations
  • Error Handling: Comprehensive timeout and error management

Security Features

  • Input sanitization for AppleScript injection prevention
  • URL encoding for special characters
  • Timeout protection (10 second limit)
  • Safe string escaping

Performance Considerations

  • Async operations throughout
  • Efficient AppleScript execution
  • JSON parsing with fallback defaults
  • Memory-efficient data handling

API Reference

Task Creation Parameters

{
  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
}

Backup Data Structure

{
  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
  }
}

Repository

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

Issues & Support

Report issues at: https://github.com/upup666/things3-mcp-dxt-extension/issues

🚀 Ready to supercharge your Things 3 workflow with AI assistance!