TaskMaster Todoist

🚀 TaskMaster: Servidor MCP Todoist para Cursor AI

Uma implementação de servidor Model Context Protocol (MCP) para integração com Todoist, desenvolvida especificamente para Cursor AI. Este servidor permite que os assistentes do Cursor AI interajam com suas tarefas do Todoist diretamente do seu ambiente de codificação.

Vídeo de Demonstração

Recursos

• Filtragem Flexível de Tarefas: Filtre tarefas usando a poderosa sintaxe de filtros do Todoist
  • Filtre por data de vencimento: hoje, amanhã, atrasadas
  • Filtre por níveis de prioridade (1-4, onde 1 é a mais alta)
  • Filtre usando combinações complexas de consultas
• Formatação Rica de Tarefas: Cada tarefa exibe prioridade, data de vencimento e outras informações relevantes com ícones claros
• Integração com Cursor AI: Use o Todoist perfeitamente dentro do seu ambiente de codificação Cursor AI

Instalação

Instalando via Smithery

Para instalar o TaskMaster para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @mingolladaniele/taskMaster-todoist-mcp --client claude

Pré-requisitos

• Python 3.10 ou superior
• Poetry (para gerenciamento de dependências)
• Conta Todoist e token de API

Configuração

1. Clone este repositório:

git clone https://github.com/mingolladaniele/todoist-mcp.git
cd todoist-mcp

2. Instale as dependências:

pip install -r requirements.txt

3. Defina seu token de API do Todoist como uma variável de ambiente:

# Linux/macOS
export TODOIST_API_TOKEN="your-api-token-here"

# Windows
set TODOIST_API_TOKEN="your-api-token-here"

Você pode encontrar seu token de API do Todoist em Configurações do Todoist → Integrações → Desenvolvedor.

Uso

Executando o servidor

python server.py

Ferramenta MCP

O servidor fornece a seguinte ferramenta MCP:

get_tasks_tool

Recupera tarefas com opções poderosas de filtragem.

Parâmetros:

• filter_string: String de consulta de filtro avançada do Todoist para filtragem complexa
• priority: Nível de prioridade opcional (1-4, onde 1 é a prioridade mais alta)

Exemplos de strings de filtro:

• "today" - Tarefas com vencimento hoje
• "overdue" - Tarefas atrasadas
• "Jan 3" - Tarefas com vencimento em 3 de janeiro
• "due before: May 5" - Tarefas com vencimento antes de 5 de maio
• "due after: May 5" - Tarefas com vencimento depois de 5 de maio
• "due before: +4 hours" - Tarefas com vencimento nas próximas quatro horas e todas as tarefas atrasadas
• "no date" - Tarefas sem data de vencimento
• "5 days" ou "next 5 days" - Tarefas com vencimento nos próximos 5 dias
• "recurring" - Tarefas com data recorrente

Configurando com Cursor AI

Para usar com Cursor AI, crie ou edite o arquivo de configuração MCP:

Windows: C:\Users\<username>\.cursor\mcp.json

{
  "mcpServers": {
    "todoist-mcp": {
      "command": "C:/Users/<username>/path/to/todoist-mcp/.venv/Scripts/python.exe",
      "args": [
        "C:/Users/<username>/path/to/todoist-mcp/server.py"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Substitua <username> e os caminhos pelo seu nome de usuário real e os caminhos corretos para sua instalação.

Depois de fazer isso, vá para Configurações do Cursor → MCP e verifique se o servidor está rodando corretamente (ponto verde).

Estrutura do Projeto

O código está organizado em módulos:

• api/: Wrapper de API para Todoist
• config/: Configuração e definições
• utils/: Funções utilitárias e auxiliares, incluindo formatação de tarefas

Roadmap

Aqui estão os recursos planejados para versões futuras:

• Criação de Tarefas: Adicione novas tarefas ao seu Todoist diretamente do Cursor AI
• Conclusão de Tarefas: Marque tarefas como concluídas sem mudar de contexto
• Exclusão de Tarefas: Remova tarefas que não são mais necessárias
• Balanceamento Inteligente de Tarefas: Rebalanceamento de tarefas com IA baseado em:
  • Prioridade do projeto
  • Compromissos de tempo
  • Datas de vencimento
  • Carga de trabalho atual
• Gerenciamento de Projetos: Crie e gerencie projetos no Todoist
• Rótulos e Filtros: Adicione rótulos personalizados e crie filtros salvos

Licença

Licença MIT