Usare Todoist MCP con Claude Code

Collega il server MCP di Todoist a Claude Code per gestire i tuoi task direttamente dal terminale. Una volta configurato, potrai creare, visualizzare e aggiornare progetti e attività su Todoist senza mai uscire dal tuo ambiente di sviluppo: la soluzione ideale per non interrompere il flusso di lavoro mentre tieni traccia dei tuoi impegni.

Se preferisci un'esperienza basata sulla chat tradizionale, puoi collegare Todoist a Claude anche tramite il connettore ufficiale. Una volta effettuato il collegamento, Claude potrà consultare, creare e aggiornare i tuoi dati. Per saperne di più, consulta la guida Usare Todoist con Claude.

Verifica i requisiti

Un piano Claude a pagamento: Pro, Max, Team, Enterprise o Console. Il piano gratuito di Claude.ai non include l’accesso a Claude Code.
Claude Code installato e autenticato sul tuo computer.
Accesso tramite OAuth: autorizzerai Claude Code ad accedere a Todoist in tutta sicurezza attraverso il server MCP ufficiale di Todoist.

Configura Todoist MCP in Claude Code

1. Aggiungi il server MCP di Todoist

Apri il terminale ed esegui il seguente comando:

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

2. Conferma l'aggiunta del server

Una volta completato il comando, nel terminale apparirà questa risposta:

1 MCP server needs auth · /mcp

Questo conferma che il server MCP di Todoist è stato inserito correttamente ed è in attesa di autorizzazione.

3. Apri l'elenco dei server MCP

Nello stesso terminale, digita /mcp e premi Invio. Si aprirà la lista di tutti i tuoi server MCP installati, incluso quello di Todoist.

4. Seleziona il server Todoist

Usa le frecce della tastiera ↑ e ↓ per spostarti su Todoist nell'elenco, poi premi Invio.

5. Completa l'autorizzazione

Segui le istruzioni sullo schermo nel tuo browser per accedere al tuo account Todoist e concedere a Claude Code i permessi necessari.

Una volta completato questo passaggio, Todoist sarà pronto all'uso all'interno di Claude Code.

A cosa avrà accesso Claude Code?

Una volta connesso, Claude Code potrà utilizzare il server MCP di Todoist per:

Leggere le tue attività e i tuoi progetti di Todoist
Creare attività e progetti
Modificare attività e progetti (ad esempio: rinominare, ripianificare o spostare in un progetto diverso)

Attenzione

Poiché questa connessione supporta le azioni di scrittura, Claude Code può apportare modifiche reali ai tuoi dati su Todoist quando glielo chiedi. Ti consigliamo di verificare sempre le modifiche prima di confermarle.

Esempi di cosa puoi fare

Ecco alcune richieste efficaci che puoi fare a Claude Code una volta configurato il server:

Categoria	Esempi di comandi
Catturare task dal codice	Aggiungi un task a Todoist: 'Correggi il bug di autenticazione in login.js' e inseriscilo nel progetto Ingegneria. Crea un'attività per 'Scrivere i test unitari per il modulo di pagamento' e imposta la scadenza a questo venerdì.
Pianificare il lavoro	Elenca tutti i miei task di Todoist scaduti e aiutami a decidere cosa affrontare oggi. Mostrami tutto ciò che scade questa settimana e suggeriscimi cosa posso realisticamente portare a termine.
Gestire la sezione In arrivo	Esamina la mia sezione In arrivo di Todoist e trasforma ogni elemento in uno step successivo chiaro e azionabile. Sposta tutti i task contrassegnati come '@in_attesa' nella sezione 'In attesa di' e aggiungi un task di follow-up per lunedì prossimo.
Mantenere il focus	Sto lavorando alla funzione di checkout: controlla Todoist e dimmi se ci sono task aperti correlati. Aggiungi un task su Todoist per ogni commento TODO presente in questo file e inseriscili tutti nel progetto dello sprint attuale.

Privacy e trattamento dei dati

Quando colleghi Todoist tramite MCP, i dati delle tue attività vengono condivisi sia con i server di Todoist che con quelli di Anthropic (Claude). Il trattamento dei dati da parte di Todoist è regolato dalla nostra Informativa sulla Privacy. I dati che entrano nel contesto di Claude (task, progetti, ecc.) sono soggetti all'Informativa sulla Privacy di Anthropic.

Puoi controllare o revocare le autorizzazioni concesse in qualsiasi momento visitando Impostazioni > Integrazioni sul tuo account Todoist.

Disconnettere Todoist MCP

Puoi rimuovere il collegamento in due modi:

Da Claude Code: esegui il comando claude mcp remove todoist nel tuo terminale per eliminare il server.
Da Todoist: vai su Impostazioni > Integrazioni e revoca l'accesso a Claude Code.

Risoluzione problemi

Il comando `claude mcp add` non viene riconosciuto

Assicurati che Claude Code sia installato correttamente e aggiornato all'ultima versione. Fai riferimento alla documentazione ufficiale di Claude Code per le istruzioni di installazione.

La finestra del browser per l'autenticazione (OAuth) non si apre

Prova a eseguire nuovamente il comando in Claude Code. Se la finestra continua a non apparire, verifica che il tuo browser non stia bloccando i pop-up e riprova.

Il server appare in claude mcp list ma gli strumenti di Todoist non sono disponibili

Avvia una nuova sessione di Claude Code dopo aver aggiunto il server. I server MCP vengono caricati solo all'avvio della sessione; una sessione già attiva non rileverà automaticamente le nuove connessioni.

Segnala un bug o richiedi una funzionalità

Il server MCP di Todoist è un progetto open source. Puoi segnalare bug, richiedere nuove funzioni o consultare i problemi noti visitando il repository ufficiale di Todoist AI su GitHub.

Contattaci

Se hai domande su come collegare Todoist MCP a Claude Code o vuoi saperne di più, contattaci.