Todoist
Gerencie projetos, seções, tarefas e etiquetas do Todoist usando linguagem natural com assistentes de IA.
Documentação
Servidor MCP Todoist
Um servidor Model Context Protocol (MCP) que conecta a API do Todoist a assistentes de IA como o Claude. Este servidor permite que assistentes de IA interajam com seus projetos, seções, tarefas e etiquetas do Todoist, permitindo que você gerencie todo o seu fluxo de trabalho de produtividade por meio de conversas em linguagem natural.
O servidor MCP do Todoist fornece uma ponte entre assistentes de IA e seu espaço de trabalho do Todoist, permitindo gerenciamento contínuo de projetos, seções, tarefas e etiquetas por meio de interfaces conversacionais.
Sumário
Pré-requisitos
Antes de usar este servidor MCP, você precisará de um token da API do Todoist:
- Acesse Configurações do Desenvolvedor do Todoist
- Copie seu token da API
Uso
Para usar este servidor com um cliente MCP, adicione a seguinte configuração:
{
"mcpServers": {
"todoist": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TODOIST_API_TOKEN=<your_api_token_here>",
"ghcr.io/koki-develop/todoist-mcp-server:latest"
]
}
}
}
Substitua <your_api_token_here> pelo seu token real da API do Todoist.
Ferramentas MCP
O servidor fornece as seguintes ferramentas que os assistentes de IA podem usar para interagir com seus dados do Todoist:
Projetos
get_projects
Recupera todos os projetos do Todoist acessíveis ao usuário autenticado. Retorna informações abrangentes do projeto, incluindo projetos pessoais e de espaço de trabalho, com metadados como nome, cor, status de favorito, estilo de visualização e informações de hierarquia.
get_project
Acessa informações detalhadas de um projeto específico do Todoist usando seu identificador exclusivo. Fornece metadados completos do projeto, incluindo configuração, hierarquia e detalhes organizacionais.
create_project
Cria um novo projeto do Todoist com configurações personalizáveis.
update_project
Modifica as propriedades de um projeto existente do Todoist.
delete_project
Exclui permanentemente um projeto do Todoist pelo seu identificador exclusivo. Esta ação remove o projeto e todas as tarefas, seções e comentários associados. Esta operação não pode ser desfeita.
Seções
get_sections
Recupera todas as seções dentro de um projeto específico do Todoist. Retorna uma lista abrangente de seções com seus metadados, como nome, ordem, carimbos de data/hora de criação e atualização e informações de status. As seções são retornadas na ordem de exibição dentro do projeto.
get_section
Acessa informações detalhadas de uma seção específica do Todoist usando seu identificador exclusivo. Fornece metadados completos da seção, incluindo nome, atribuição de projeto, posição de ordem, carimbos de data/hora e sinalizadores de status.
create_section
Cria uma nova seção dentro de um projeto do Todoist para organizar tarefas. As seções ajudam a categorizar e agrupar tarefas relacionadas dentro de um projeto.
update_section
Modifica o nome de uma seção existente do Todoist. Atualmente, apenas o nome da seção pode ser atualizado.
delete_section
Exclui permanentemente uma seção do Todoist pelo seu identificador exclusivo. Esta ação remove a seção e move quaisquer tarefas nesta seção para a área principal do projeto. Esta operação não pode ser desfeita.
Tarefas
get_tasks
Recupera tarefas do Todoist com opções flexíveis de filtragem. Retorna uma lista abrangente de tarefas com seus metadados, incluindo conteúdo, descrição, atribuição de projeto, datas de vencimento, níveis de prioridade, etiquetas, status de conclusão e informações de hierarquia. Sem filtros, retorna todas as tarefas acessíveis ao usuário autenticado.
get_tasks_by_filter
Recupera tarefas do Todoist usando sintaxe avançada de filtro. Suporta consultas de filtro poderosas usando a sintaxe de filtro em linguagem natural do Todoist para pesquisas complexas de tarefas. Lida automaticamente com a paginação para recuperar todas as tarefas correspondentes.
get_task
Acessa informações detalhadas de uma tarefa específica do Todoist usando seu identificador exclusivo. Fornece metadados completos da tarefa, incluindo conteúdo, descrição, atribuição de projeto e seção, informações de data de vencimento, nível de prioridade, etiquetas atribuídas, status de conclusão, relacionamentos pai-filho e carimbos de data/hora.
create_task
Cria uma nova tarefa do Todoist com opções abrangentes de configuração.
update_task
Modifica as propriedades de uma tarefa existente do Todoist.
delete_task
Exclui permanentemente uma tarefa do Todoist pelo seu identificador exclusivo. Esta ação remove a tarefa e todos os comentários e anexos associados. Se a tarefa tiver subtarefas, elas também serão excluídas. Esta operação não pode ser desfeita.
close_task
Marca uma tarefa do Todoist como concluída. Esta ação move a tarefa para o estado concluído, preservando todos os dados e histórico da tarefa. Tarefas concluídas podem ser reabertas posteriormente, se necessário.
reopen_task
Reabre uma tarefa do Todoist anteriormente concluída, retornando-a ao status ativo. Esta ação restaura a tarefa ao seu estado anterior à conclusão.
move_tasks_to_project
Move várias tarefas para um projeto diferente dentro do Todoist. Esta ferramenta permite a reorganização eficiente de tarefas em massa, alterando a atribuição de projeto para várias tarefas simultaneamente. Todas as tarefas especificadas serão movidas de seus locais atuais para o projeto de destino.
move_tasks_to_section
Move várias tarefas para uma seção diferente dentro do Todoist. Esta ferramenta permite a organização de tarefas em massa, alterando a atribuição de seção para várias tarefas de uma vez. Todas as tarefas especificadas serão movidas de seus locais atuais para a seção de destino.
move_tasks_to_parent
Move várias tarefas para se tornarem subtarefas de outra tarefa dentro do Todoist. Esta ferramenta permite a criação de hierarquias de tarefas, tornando várias tarefas filhas de uma tarefa pai especificada. Todas as tarefas especificadas serão convertidas em subtarefas do pai de destino.
Etiquetas
create_label
Cria uma nova etiqueta pessoal com propriedades personalizáveis, incluindo nome, cor, ordem de exibição e status de favorito. As etiquetas podem ser usadas para categorizar e organizar tarefas em todos os projetos.
update_label
Modifica as propriedades de uma etiqueta pessoal existente. Permite alterar o nome, a cor, a ordem de exibição e o status de favorito da etiqueta. Todos os parâmetros, exceto o ID da etiqueta, são opcionais, para que você possa atualizar apenas as propriedades específicas que deseja alterar.
get_label
Recupera uma etiqueta pessoal específica pelo seu ID exclusivo com metadados completos, incluindo nome, cor, ordem e status de favorito. Retorna informações detalhadas sobre a etiqueta solicitada para uso na organização e filtragem de tarefas. Requer um ID de etiqueta válido que pertença ao usuário autenticado.
get_labels
Recupera todas as etiquetas pessoais acessíveis ao usuário autenticado com seus metadados completos, incluindo nome, cor, ordem e status de favorito. Retorna uma lista abrangente de etiquetas que podem ser usadas para organização e filtragem de tarefas. Esta ferramenta fornece acesso somente leitura às informações de etiquetas e lida com a paginação automaticamente.
delete_label
Exclui permanentemente uma etiqueta pessoal pelo seu identificador exclusivo. AVISO: Esta ação é IRREVERSÍVEL e removerá automaticamente a etiqueta de todas as tarefas associadas. Use com cautela, pois etiquetas excluídas não podem ser recuperadas.
Comentários
create_task_comment
Adiciona um comentário a uma tarefa específica do Todoist. Suporta conteúdo de rich text e anexos de arquivo opcionais. Retorna o objeto de comentário completo com todos os metadados após a criação bem-sucedida.
create_project_comment
Adiciona um comentário a um projeto específico do Todoist. Suporta conteúdo de rich text e anexos de arquivo opcionais. Retorna o objeto de comentário completo com todos os metadados após a criação bem-sucedida.
update_comment
Atualiza o conteúdo de um comentário existente no Todoist. Isso permite modificar o conteúdo de texto de comentários em tarefas ou projetos. Os metadados do comentário, como horário de postagem, autor e anexos, são preservados. Retorna o objeto de comentário atualizado com o conteúdo atual.
get_task_comments
Recupera todos os comentários associados a uma tarefa específica do Todoist. Retorna uma lista abrangente de comentários com seus metadados, incluindo conteúdo, informações do autor, carimbos de data/hora, anexos de arquivo e reações. Os comentários são retornados em ordem cronológica. Lida automaticamente com a paginação para recuperar todos os comentários da tarefa.
get_project_comments
Recupera todos os comentários associados a um projeto específico do Todoist. Retorna uma lista abrangente de comentários de nível de projeto com seus metadados, incluindo conteúdo, informações do autor, carimbos de data/hora, anexos de arquivo e reações. Os comentários são retornados em ordem cronológica. Lida automaticamente com a paginação para recuperar todos os comentários do projeto.
delete_comment
Exclui permanentemente um comentário pelo seu identificador exclusivo. Esta ação removerá o comentário da sua tarefa ou projeto associado. Esta operação não pode ser desfeita, portanto use com cautela. Retorna confirmação de exclusão bem-sucedida ou notificação de falha.
Licença
Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.
Copyright (c) 2025 Koki Sato