Things 3 Extended

Uma extensão de desktop para o gerenciador de tarefas Things 3, fornecendo recursos avançados como movimentação de tarefas, edição e backups.

GitHub
3

Documentação

Servidor MCP Things 3 Extended - Extensão DXT

Uma Extensão de Desktop (DXT) abrangente para integração com o gerenciamento de tarefas do Things 3, com capacidades aprimoradas incluindo movimentação de tarefas, edição e funcionalidade de backup.

Recursos

📋 Operações de Visualização

  • view_inbox - Visualizar todas as tarefas na caixa de entrada do Things 3
  • view_today - Visualizar todas as tarefas agendadas para hoje
  • view_projects - Visualizar todos os projetos no Things 3
  • view_areas - Visualizar todas as áreas no Things 3

➕ Operações de Criação

  • create_task - Criar novas tarefas com metadados completos (notas, datas, tags, listas de verificação)
  • create_project - Criar novos projetos com áreas e agendamento
  • create_area - Criar novas áreas organizacionais

🔄 Operações de Movimentação de Tarefas

  • move_task_to_inbox - Mover tarefas de hoje/outras listas de volta para a caixa de entrada
  • move_task_to_today - Agendar tarefas da caixa de entrada para hoje
  • move_task_to_project - Atribuir tarefas a projetos específicos
  • move_task_to_area - Mover tarefas para áreas específicas

✏️ Operações de Edição

  • edit_task - Modificar propriedades de tarefas existentes (título, notas, datas, tags)
  • edit_project - Atualizar detalhes e metadados de projetos

🔍 Operações de Gerenciamento

  • search_tasks - Pesquisar tarefas por título ou conteúdo
  • complete_task - Marcar tarefas como concluídas

💾 Operações de Backup e Restauração

  • backup_things3 - Criar backup abrangente de todos os dados do Things 3
  • restore_things3 - Carregar dados de backup (análise e referência)

Instalação

Pré-requisitos

  • macOS (necessário para o Things 3)
  • Aplicativo Things 3 instalado
  • Node.js 18.0.0 ou superior
  • Host compatível com DXT (Claude Desktop, etc.)

Instalar Dependências

cd server
npm install

Empacotar como Extensão DXT

Como a CLI do DXT ainda não está disponível publicamente, crie o pacote 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: Exclua o diretório .claude/ para evitar erros de instalação no Claude Desktop.

Adicionar ao Aplicativo Host

Adicione a extensão à configuração do seu host compatível com MCP:

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

Exemplos de Uso

Fluxo de Trabalho de Gerenciamento de Tarefas

// 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"
});

Backup e Recuperação

// 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"
});

Implementação Técnica

Arquitetura

  • Protocolo MCP: Usa @modelcontextprotocol/sdk para comunicação
  • Integração AppleScript: Interação direta com o Things 3 via AppleScript
  • Esquemas de URL: Aproveita os esquemas de URL do Things 3 para operações de criação
  • Tratamento de Erros: Gerenciamento abrangente de timeout e erros

Recursos de Segurança

  • Saneamento de entrada para prevenção de injeção AppleScript
  • Codificação de URL para caracteres especiais
  • Proteção contra timeout (limite de 10 segundos)
  • Escape seguro de strings

Considerações de Desempenho

  • Operações assíncronas em todo o sistema
  • Execução eficiente de AppleScript
  • Análise JSON com padrões de fallback
  • Manipulação de dados com eficiência de memória

Referência da API

Parâmetros de Criação de Tarefas

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

Estrutura de Dados de Backup

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

Solução de Problemas

Problemas Comuns

  1. "Things 3 não está respondendo"

    • Certifique-se de que o Things 3 esteja em execução
    • Verifique as permissões do macOS para AppleScript

  2. Erros de "Tarefa não encontrada"

    • A pesquisa usa correspondência parcial
    • Verifique os títulos exatos das tarefas
    • As tarefas podem estar em listas diferentes

  3. Falhas de backup/restauração

    • Verifique as permissões do caminho do arquivo
    • Garanta espaço em disco suficiente
    • Verifique a sintaxe JSON nos arquivos de backup

Modo de Depuração

Defina NODE_ENV=development para registro detalhado:

NODE_ENV=development node server/index.js

Licença

Licença MIT - Consulte o arquivo LICENSE para obter detalhes.

Repositório

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

Contribuição

Contribuições são bem-vindas! Por favor, siga o estilo de código existente e adicione testes para novos recursos.

Problemas e Suporte

Relate problemas em: https://github.com/upup666/things3-mcp-dxt-extension/issues

🚀 Pronto para turbinar seu fluxo de trabalho no Things 3 com assistência de IA!