Todoist

Um servidor não oficial para gerenciar tarefas do Todoist, permitindo que agentes criem, listem e concluam tarefas.

GitHub

Documentação

Servidor MCP Todoist

Servidor MCP não oficial para Todoist que permite que agentes criem e listem tarefas na sua conta Todoist.

Recursos

  • Criar tarefas com descrições, datas de vencimento, prioridades, etiquetas e projetos.
  • Listar tarefas Liste tarefas concluídas ou não concluídas com filtros por projeto ou filtros do Todoist.

Funciona com Claude Desktop, Cursor e outros clientes MCP

Instalação

pip install todoist-mcp-server

Configuração

1. Obtenha seu Token da API do Todoist

  1. Acesse Configurações de Integrações do Todoist
  2. Role até "API token"
  3. Copie seu token da API (mantenha-o seguro!)

2. Configure Seu Cliente MCP

Exemplos de Uso

Aqui estão alguns exemplos de como usar o servidor MCP Todoist com diferentes clientes:

Claude Desktop

Adicione isso ao seu arquivo claude_desktop_config.json: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%/Claude/claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "todoist": {
      "command": "todoist-mcp-server",
      "env": {
        "TODOIST_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Cursor

Adicione isso às configurações do Cursor:

  1. Abra as Configurações do Cursor (Cmd/Ctrl + ,)
  2. Pesquise por "MCP"
  3. Adicione a configuração do servidor MCP:
{
  "mcpServers": {
    "todoist": {
      "command": "todoist-mcp-server",
      "env": {
        "TODOIST_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Outros Clientes MCP

Para qualquer cliente compatível com MCP, use:

  • Comando: todoist-mcp-server
  • Variável de Ambiente: TODOIST_API_TOKEN=your-token

3. Reinicie Seu Cliente

Reinicie o Claude Desktop, Cursor ou seu cliente MCP para carregar o servidor.

Uso

Uma vez configurado, você pode interagir com o Todoist usando linguagem natural:

Criando Tarefas

  • "Crie uma tarefa para comprar mantimentos"
  • "Adicione uma tarefa 'Ligar para o dentista' com vencimento amanhã e prioridade alta"
  • "Crie uma tarefa para terminar o relatório com descrição 'Incluir métricas do Q4' com vencimento na próxima sexta-feira"

Listando Tarefas

  • "Mostre minhas tarefas para hoje"
  • "Liste todas as minhas tarefas de alta prioridade"
  • "Quais tarefas tenho no meu projeto Trabalho?"

Ferramentas Disponíveis

create_task

Crie uma nova tarefa no Todoist.

Parâmetros:

  • content (obrigatório): Título/conteúdo da tarefa
  • description (opcional): Descrição da tarefa
  • project_name (opcional): Nome do projeto para adicionar a tarefa
  • due_string (opcional): Data de vencimento em linguagem natural ("amanhã", "próxima segunda-feira")
  • priority (opcional): Nível de prioridade 1-4 (1=baixa, 2=média, 3=alta, 4=urgente)
  • labels (opcional): Lista de nomes de etiquetas

list_active_tasks

Liste tarefas ativas do Todoist.

Parâmetros:

  • project_name (opcional): Filtrar por nome do projeto
  • filter_string (opcional): Filtro do Todoist ("hoje", "atrasadas", "p1")
  • limit (opcional): Número máximo de tarefas (padrão: 50)

Solução de Problemas

Erro "Servidor desconectado"

  1. Certifique-se de que instalou o pacote: pip install todoist-mcp-server
  2. Verifique se seu token da API está correto
  3. Confirme que o arquivo de configuração está no local correto
  4. Reinicie completamente seu cliente MCP

Erro "Comando não encontrado" ou "ENOENT"

A causa mais comum é que seu cliente MCP não consegue encontrar o comando todoist-mcp-server no PATH.

Solução: Use o caminho completo para o comando

  1. Descubra onde o comando está instalado:

    which todoist-mcp-server

  2. Use o caminho completo na sua configuração MCP:

    {
  "mcpServers": {
    "todoist": {
      "command": "/full/path/to/todoist-mcp-server",
      "env": {
        "TODOIST_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Outras correções:

  • Certifique-se de que o pacote está instalado no mesmo ambiente Python que seu cliente MCP usa
  • Tente reinstalar: pip uninstall todoist-mcp-server && pip install todoist-mcp-server

Problemas com o Token da API

  • Obtenha um novo token em Integrações do Todoist
  • Certifique-se de que não há espaços extras no seu arquivo de configuração
  • Verifique se o token tem as permissões necessárias

Desenvolvimento

Para contribuir ou executar a partir do código-fonte:

git clone https://github.com/mehularora8/todoist-mcp
cd todoist-mcp
pip install -e .

Segurança

  • Seu token da API é armazenado localmente e usado apenas para se comunicar com a API do Todoist
  • Nenhum dado é enviado a terceiros
  • O servidor MCP roda localmente na sua máquina

Licença

Licença MIT - consulte o arquivo LICENSE para detalhes.

Suporte

Nota: Esta é uma integração não oficial e não é afiliada ao Todoist ou à Doist Inc.