Todoist

Servidor MCP Todoist

Um servidor Model Context Protocol (MCP) que permite que clientes como o Claude interajam com o Todoist, habilitando recursos de gerenciamento de tarefas por meio de linguagem natural. O servidor atua como intermediário entre clientes e a API do Todoist, lidando com autenticação, transformação de dados e processamento de comandos. Esta é uma versão em Python

Recursos

• Criação de Tarefas: Crie novas tarefas com conteúdo obrigatório e atributos opcionais
• Recuperação de Tarefas: Obtenha tarefas por ID ou liste tarefas com opções de filtro
• Gerenciamento de Tarefas: Atualize atributos de tarefas, marque tarefas como concluídas, exclua tarefas

Pré-requisitos

• Python 3.12
• uv
• Uma conta Todoist e token de API

Como obter o Token da API do Todoist

1. Faça login na sua conta Todoist
2. Vá para Configurações do Usuário -> Integrações -> Desenvolvedor
3. Copie o token da API

Uso com o Claude Desktop

Execute via UVX (sem clonar)

Você pode executar o servidor diretamente do GitHub usando UVX:

uvx --from https://github.com/Johnxjp/todoist-mcp-python.git mcp-server-todoist

Em seguida, adicione esta configuração às suas configurações do Claude:

{
  "mcpServers": {
    "todoist-server": {
      "command": "uvx",
      "args": [
        "--from", 
        "https://github.com/Johnxjp/todoist-mcp-python.git", 
        "mcp-server-todoist"
      ],
      "env": {
        "TODOIST_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Execute a partir do repositório clonado

Se preferir clonar o repositório, use estes comandos:

git clone git@github.com:Johnxjp/todoist-mcp-python.git

Em seguida, adicione ao seu arquivo de configuração do Claude:

{
  "mcpServers": {
    "todoist-server": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "todoist_api_python",
        "mcp",
        "run",
        "/full/path/to/todoist_server.py"
      ],
      "env": {
        "TODOIST_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Ferramentas Disponíveis

O servidor fornece as seguintes ferramentas para o Claude usar:

1. create_task: Crie uma nova tarefa no Todoist
   • Obrigatório: content (título da tarefa)
     • Opcional:
     • description, - due_date, - priority, - project_id, - section_id, - labels
2. get_tasks: Obtenha uma lista de tarefas e IDs do Todoist com vários filtros
   • Opcional:
     • project_id, - project_name, - task_name, - priority, - labels, - is_overdue, - limit
3. update_task: Atualize uma tarefa existente pesquisando-a pelo nome
   • Obrigatório: task_id
     • Opcional:
     • content, - description, - labels, - priority, - due_date (AAAA-MM-DD), - deadline_date (AAAA-MM-DD)
4. delete_task: Exclua uma tarefa pesquisando-a pelo nome
   • Obrigatório: task_id
5. complete_task: Marque uma tarefa como concluída pesquisando-a pelo nome
   • Obrigatório: task_id

Exemplos de Interação

Aqui estão alguns exemplos de como o Claude pode interagir com o Todoist por meio deste servidor MCP:

• "Adicione uma tarefa para comprar mantimentos"
• "Mostre-me todas as minhas tarefas urgentes"
• "Quais tarefas vencem hoje?"
• "Marque a tarefa de lavanderia como concluída"
• "Altere a prioridade da minha consulta com o dentista para urgente"

Considerações de Segurança

• O servidor lida com segurança com seu token da API do Todoist por meio de variáveis de ambiente
• Nunca compartilhe seu arquivo .env ou exponha seu token da API
• O servidor é executado localmente e se comunica apenas com a API do Todoist