Todoist MCP

Servidor Todoist MCP

Uma implementação de servidor MCP (Model Context Protocol) que integra o Claude ao Todoist, permitindo gerenciamento de tarefas em linguagem natural. Este servidor permite que o Claude interaja com suas tarefas do Todoist usando linguagem cotidiana.

Recursos

• Gerenciamento de Tarefas em Linguagem Natural: Crie, atualize, conclua e exclua tarefas usando linguagem cotidiana
• Busca Inteligente de Tarefas: Encontre tarefas usando correspondências parciais de nome
• Filtragem Flexível: Filtre tarefas por data de vencimento, prioridade e outros atributos
• Detalhes Ricos de Tarefas: Suporte para descrições, datas de vencimento e níveis de prioridade
• Tratamento Intuitivo de Erros: Feedback claro para melhor experiência do usuário

Instalação

Instalando via Smithery

Para instalar o Servidor Todoist MCP para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude

Instalação Manual

npm install -g @abhiz123/todoist-mcp-server

Ferramentas

todoist_create_task

Crie novas tarefas com vários atributos:

• Obrigatório: conteúdo (título da tarefa)
• Opcional: descrição, data de vencimento, nível de prioridade (1-4)
• Exemplo: "Criar tarefa 'Reunião de Equipe' com descrição 'Sincronização semanal' para amanhã"

todoist_get_tasks

Recupere e filtre tarefas:

• Filtre por data de vencimento, prioridade ou projeto
• Filtragem de data em linguagem natural
• Limite de resultados opcional
• Exemplo: "Mostrar tarefas de alta prioridade com vencimento esta semana"

todoist_update_task

Atualize tarefas existentes usando busca em linguagem natural:

• Encontre tarefas por correspondência parcial de nome
• Atualize qualquer atributo da tarefa (conteúdo, descrição, data de vencimento, prioridade)
• Exemplo: "Atualizar tarefa de reunião para vencimento na próxima segunda-feira"

todoist_complete_task

Marque tarefas como concluídas usando busca em linguagem natural:

• Encontre tarefas por correspondência parcial de nome
• Confirme o status de conclusão
• Exemplo: "Marcar a tarefa de documentação como concluída"

todoist_delete_task

Remova tarefas usando busca em linguagem natural:

• Encontre e exclua tarefas por nome
• Mensagens de confirmação
• Exemplo: "Excluir a tarefa de revisão do PR"

Configuração

Obtendo um Token da API do Todoist

1. Faça login na sua conta do Todoist
2. Navegue até Configurações → Integrações
3. Encontre seu token da API em "Desenvolvedor"

Uso com Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["-y", "@abhiz123/todoist-mcp-server"],
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Exemplo de Uso

Criando Tarefas

"Create task 'Team Meeting'"
"Add task 'Review PR' due tomorrow at 2pm"
"Create high priority task 'Fix bug' with description 'Critical performance issue'"

Obtendo Tarefas

"Show all my tasks"
"List tasks due today"
"Get high priority tasks"
"Show tasks due this week"

Atualizando Tarefas

"Update documentation task to be due next week"
"Change priority of bug fix task to urgent"
"Add description to team meeting task"

Concluindo Tarefas

"Mark the PR review task as complete"
"Complete the documentation task"

Excluindo Tarefas

"Delete the PR review task"
"Remove meeting prep task"

Desenvolvimento

Compilando a partir do código-fonte

# Clone the repository
git clone https://github.com/abhiz123/todoist-mcp-server.git

# Navigate to directory
cd todoist-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Problemas e Suporte

Se você encontrar problemas ou precisar de suporte, por favor, registre um problema no repositório do GitHub.