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/mcp2. 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)
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 Todoistno 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.