Usando o Todoist MCP com o Claude Code

Conecte o servidor MCP (Model Context Protocol) do Todoist ao Claude Code e gerencie suas tarefas diretamente do seu terminal. Uma vez conectado, você pode criar, ler e atualizar tarefas e projetos do Todoist sem sair do seu ambiente de codificação, ótimo para manter o foco enquanto acompanha o trabalho.

Você também pode conectar o Todoist ao Claude via o conector do Todoist no Claude para um fluxo de trabalho com foco em chat. Uma vez conectado, o Claude pode ler, criar e atualizar suas tarefas e projetos do Todoist. Consulte o artigo Usar o Todoist com o Claude para obter as instruções.

Verifique os requisitos.

Um plano pago do Claude – Pro, Max, Equipe, Enterprise ou Console. O plano grátis do Claude.ai não inclui acesso ao Claude Code.
Claude Code instalado e autenticado na sua máquina.
Você fará login com OAuth, que autoriza o Claude Code a ter acesso ao Todoist através do servidor oficial Todoist MCP.

Configurar o Todoist MCP no Claude Code

1. Adicione o servidor Todoist MCP.

Abra seu terminal e execute o seguinte comando:

claude mcp adicionar --transport http Todoist https://ai.todoist.net/mcp

2. Confirme se o servidor foi adicionado

Assim que o comando for concluído, você verá a seguinte resposta aparecer no seu terminal:

O servidor MCP precisa de autenticação · /mcp

Isso confirma que o servidor MCP do Todoist foi adicionado e está aguardando sua autorização.

3. Abra a lista de servidores MCP

No mesmo terminal, digite /mcp e pressione Enter. Isso abrirá uma lista de todos os seus servidores MCP instalados, incluindo o recém-adicionado do Todoist.

4. Selecione o servidor Todoist

Use as setas ↑ e ↓ para navegar até Todoist na lista e, em seguida, pressione Enter.

5. Conclua o fluxo de autorizações

Siga as instruções na tela para entrar na sua conta Todoist e conceder as permissões necessárias ao Claude Code.

Após a autorização, o Todoist estará pronto para usar no Claude Code.

A que o Claude Code terá acesso

Uma vez conectado, o Claude Code pode usar o servidor MCP do Todoist para:

Ler suas tarefas e projetos do Todoist
Criar tarefas e projetos
Atualizar tarefas e projetos (por exemplo: renomear, reagendar ou mover para um projeto diferente)

Aviso

Como esta conexão oferece suporte a ações de gravação, o Claude Code pode fazer alterações nos seus dados do Todoist quando você o instruir. Revise todas as ações antes de confirmá-las.

Exemplos do que você pode fazer

Aqui estão algumas sugestões que funcionam bem depois de você se conectar:

Categoria	Exemplos de prompts
Capturar tarefas do seu código	Adicione uma tarefa ao Todoist: "Corrigir o bug de autenticação em login.js" e coloque-a no projeto Engenharia. Crie uma tarefa para "Escrever testes de unidade para o módulo de pagamento" e defina-a para esta sexta-feira.
Planeje seu trabalho	Liste todas as minhas tarefas atrasadas do Todoist e me ajude a decidir o que fazer hoje. Mostre-me tudo o que vence esta semana e sugira o que posso realmente concluir.
Organize sua caixa de entrada	Analise minha Entrada do Todoist e transforme cada item em uma próxima etapa clara e de ações. Mova todas as tarefas marcadas como "aguardando" para uma Seção "Aguardando por" e adicione uma tarefa de acompanhamento para a próxima segunda-feira.
Mantenha o foco	Estou trabalhando na ferramenta de checkout – verifique o Todoist e me diga se há alguma tarefa aberta relacionada. Adicione uma tarefa para cada comentário TODO neste arquivo e coloque todas no projeto do sprint atual.

Privacidade e tratamento de dados

Ao conectar o Todoist via MCP, os dados das suas tarefas são compartilhados tanto com os servidores do Todoist quanto com o Claude. O tratamento de dados por parte do Todoist é regido pela política de privacidade do Todoist; os dados que entram no contexto do Claude (suas tarefas, projetos e assim por diante) também estão sujeitos à política de privacidade da Anthropic.

Para ter mais tranquilidade, revise as permissões concedidas a qualquer momento, visitando Configurações > Integrações do Todoist.

Desconectar o Todoist MCP

Você pode desconectar de dois lugares:

No Claude Code: execute claude mcp remover Todoist no seu terminal para remover o servidor.
No Todoist: cancele o acesso em Configurações > Integrações para cancelar o acesso do Claude Code.

Resolução de problemas

O comando `claude mcp add` não é reconhecido

Certifique-se de que o Claude Code está instalado e atualizado. Consulte a documentação do Claude Code para obter instruções de instalação.

A janela do navegador OAuth não abre

Tente executar o comando Claude Code novamente. Se a janela ainda não aparecer, verifique se o seu navegador não está bloqueando pop-ups e tente novamente.

O servidor aparece na lista mcp do claude, mas as ferramentas do Todoist não estão disponíveis

Inicie uma nova sessão do Claude Code após adicionar o servidor. Os servidores MCP só carregam no início da sessão, então um existente não detectará novas conexões.

Relatar um bug ou solicitar uma ferramenta

O servidor MCP do Todoist é de fonte aberta. Você pode relatar bugs, solicitar ferramentas ou procurar problemas conhecidos no repositório oficial do Todoist AI no GitHub.

Entre em contato

Se tiver dúvidas sobre como conectar o Todoist MCP ao Claude Code ou quiser saber mais, entre em contato conosco.