Todoist MCP Server

Der Todoist MCP Server verbindet Ihre Aufgabenliste in Todoist mit KI-Assistenten. MCP, das Model Context Protocol, ist ein offener Standard, über den Assistenten wie Claude, ChatGPT, Codex oder Cursor auf externe Dienste zugreifen. Der Server stammt vom Todoist-Team selbst, der Quellcode liegt im GitHub-Konto Doist unter der MIT-Lizenz. Sie haben zwei Wege: Entweder nutzen Sie den gehosteten Dienst unter ai.todoist.net/mcp, oder Sie starten den Server lokal auf Ihrem Rechner. Der gehostete Weg braucht keine Installation. Die Anmeldung läuft dort über OAuth. OAuth ist ein Anmeldeverfahren, bei dem Sie dem Assistenten im Browser Zugriff erteilen, ohne Ihr Passwort weiterzugeben.

Wofür ist der Todoist MCP Server nützlich?

Eine Aufgabenliste lebt davon, dass Dinge schnell hineinkommen und regelmäßig aufgeräumt werden. Genau hier hilft ein Assistent. Sie können im Chat sagen, dass aus einem Besprechungsprotokoll die nächsten Schritte als Aufgaben in einem bestimmten Projekt landen sollen. Sie können fragen, was heute und morgen fällig ist, überfällige Aufgaben auf nächste Woche verschieben oder ein Projekt mit Abschnitten und Labels vorbereiten lassen. Für Entwickler ist der Server praktisch, weil Claude Code oder Codex offene Punkte aus der Arbeit am Code direkt als Aufgaben ablegen. So geht kein TODO im Terminal verloren.

Aufgaben, Projekte und Struktur

Laut Repository umfasst der Server Werkzeuge für den Alltag: Aufgaben anlegen, ändern, abhaken, wieder öffnen und umplanen sowie Aufgaben nach Datum oder Suchbegriff finden. Dazu kommen Werkzeuge für Projekte, Abschnitte, Labels, Filter, Kommentare und Erinnerungen. In geteilten Projekten kann der Assistent Aufgaben zuweisen und Mitwirkende auflisten. Projekte lassen sich als Vorlage exportieren und wieder importieren. Das Todoist-Team beschreibt sein Ziel so: lieber wenige Werkzeuge, die ganze Arbeitsabläufe abdecken, als viele kleine Einzelaktionen. Das spart dem Sprachmodell Zwischenschritte.

Auswertungen und Überblick

Neben dem Bearbeiten kann der Server auch auswerten. Es gibt Werkzeuge für eine Tagesübersicht, für Produktivitätsstatistiken, für die Aktivität in einem Projekt und für den Zustand eines Projekts. Für Teams kommen Einblicke in Arbeitsbereiche hinzu. Damit lässt sich etwa fragen, welche Projekte ins Stocken geraten sind oder was in der letzten Woche erledigt wurde. Zusätzlich bietet der Server die Werkzeuge search und fetch nach der MCP-Spezifikation von OpenAI. Das ist für ChatGPT wichtig. Über MCP Apps zeigt der Server in passenden Clients außerdem kleine Bedienelemente wie Aufgabenlisten direkt im Chat an.

Gehostet oder lokal?

Für die meisten Nutzer ist der gehostete Dienst der einfachste Weg. In Claude finden Sie Todoist im Connector-Verzeichnis, in ChatGPT als Plugin, das dann auch in Codex verfügbar ist. Für Claude Code gibt es ein offizielles Plugin, das den Server mit zwei Befehlen einrichtet. Cursor und andere Clients binden die Adresse über das Hilfsprogramm mcp-remote ein, VS Code direkt per HTTP. Wer lieber lokal arbeitet, startet den Server mit npx und einem Todoist-API-Token. Das Token finden Sie in den Todoist-Einstellungen unter Integrationen. Das Repository nennt einen weiteren Grund für den lokalen Betrieb: Beim gehosteten Dienst kann es zu häufigen Verbindungsabbrüchen kommen. Ein lokaler HTTP-Server ist dann die Alternative. Er lauscht standardmäßig nur auf dem eigenen Rechner und prüft eingehende Anfragen gegen eine Liste erlaubter Hostnamen.

Was unterscheidet ihn von Alternativen?

Im Netz gibt es mehrere inoffizielle Todoist-MCP-Server aus der Community. Sie laufen meist nur lokal und brauchen immer ein API-Token. Der offizielle Server wird vom Todoist-Team gepflegt, ist gehostet und lokal nutzbar und steht als Connector in den großen Assistenten bereit. Eine Besonderheit: Die Werkzeuge sind nicht fest an MCP gebunden. Entwickler können sie als npm-Paket in eigene Anwendungen einbauen, zum Beispiel mit dem AI SDK von Vercel.

Grenzen kennen

Die Todoist-Hilfeseite zum Claude-Connector nennt einige Grenzen. Pro Aktion verarbeitet der Assistent höchstens 25 Aufgaben. Ändert er bei einer wiederkehrenden Aufgabe das Datum, geht die Wiederholung verloren. Besser ist es, ihn um ein Umplanen zu bitten. Je nach Client können einzelne Funktionen fehlen, etwa das Verwalten von Abschnitten oder das Zuweisen in geteilten Projekten. Das Repository selbst bezeichnet das Projekt als frühes Stadium, in dem weitere Werkzeuge folgen.

Für wen lohnt sich der Todoist MCP Server?

Der Server lohnt sich für alle, die Todoist bereits nutzen und Aufgaben lieber im Gespräch mit dem Assistenten erfassen und sortieren. Wer viel in Claude Code oder Codex arbeitet, spart sich den Wechsel in die Todoist-App. Teams können Projektstände abfragen, ohne Berichte zu bauen. Zu den Kosten: Der Server selbst ist kostenlos und quelloffen. Laut Hilfeseite funktioniert die Anbindung in allen Todoist-Tarifen, also auch im kostenlosen Beginner-Plan. In Claude Team oder Enterprise muss ein Owner den Connector zuerst freigeben.

Ein Todoist-Konto in einem beliebigen Tarif. Dazu ein MCP-fähiger Client wie Claude, Claude Code, ChatGPT, Codex, Cursor oder VS Code. Für den lokalen Betrieb Node.js und ein Todoist-API-Token. In Claude Team oder Enterprise muss ein Owner den Connector freigeben.

Der Todoist MCP Server gibt Ihrem KI-Assistenten Zugriff auf Ihre Aufgaben in Todoist. Er läuft gehostet unter https://ai.todoist.net/mcp oder lokal auf Ihrem Rechner. Dieser Ratgeber zeigt beide Wege und worauf Sie danach achten sollten.

Vorher klären

Sie brauchen ein Todoist-Konto. Laut Todoist funktioniert die Anbindung in jedem Tarif, auch im kostenlosen Beginner-Plan. Nutzen Sie Claude in einem Team- oder Enterprise-Tarif, muss ein Owner den Connector für die Organisation freigeben. Bis dahin steht die Verbindung auf Requested.

Claude im Browser und in der Desktop-App

Klicken Sie unten links auf das Plus-Symbol und wählen Sie Connectors, dann Add connector und Browse connectors. Suchen Sie nach Todoist und klicken Sie auf Connect. Melden Sie sich bei Todoist an und erteilen Sie den Zugriff. Öffnen Sie danach einen neuen Chat, denn die Werkzeuge werden zu Beginn jeder Unterhaltung geladen. Alternativ legen Sie unter Settings und Connectors einen eigenen Connector mit der Server-URL an.

Schritt 1: Claude Code

Am schnellsten geht es mit dem offiziellen Plugin. Führen Sie in Claude Code /plugin marketplace add doist/todoist-mcp und danach /plugin install todoist@doist aus. Beim ersten Einsatz eines Todoist-Werkzeugs öffnet sich der Browser zur Anmeldung. Ohne Plugin tragen Sie den Server mit claude mcp add --transport http todoist https://ai.todoist.net/mcp ein, starten claude, rufen /mcp auf und wählen todoist zur Anmeldung.

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

ChatGPT und Codex

Öffnen Sie ChatGPT im Browser oder in der Desktop-App und wählen Sie in der Seitenleiste Plugins. Suchen Sie nach Todoist, installieren Sie das Plugin und melden Sie sich an. Danach steht Todoist auch in Codex bereit. Dort rufen Sie es mit @ auf oder beschreiben Ihren Wunsch einfach in normaler Sprache. Codex fragt vor schreibenden Aktionen nach.

Cursor und VS Code

In Cursor legen Sie in ~/.cursor/mcp.json oder in .cursor/mcp.json im Projekt einen Eintrag todoist an. Als command tragen Sie npx ein, als args -y, mcp-remote und https://ai.todoist.net/mcp. In VS Code öffnen Sie die Befehlspalette, wählen MCP: Add Server und dann HTTP mit der Server-URL.

Schritt 2: Lokal mit API-Token

Wer den Server selbst betreiben will, braucht Node.js und ein Todoist-API-Token aus den Einstellungen unter Integrationen. Tragen Sie in die MCP-Konfiguration Ihres Clients den Befehl npx @doist/todoist-mcp ein und setzen Sie die Umgebungsvariable TODOIST_API_KEY. Alternativ starten Sie mit npx -p @doist/todoist-mcp todoist-mcp-http einen lokalen HTTP-Server auf Port 3000. Das hilft, wenn der gehostete Dienst häufig die Verbindung verliert. Geben Sie diesen Server nicht ungeschützt im Netzwerk frei, denn er arbeitet mit Ihrem Token.

npx @doist/todoist-mcp
npx -p @doist/todoist-mcp todoist-mcp-http

Sicher arbeiten

Der Server kann Aufgaben und Projekte ändern und löschen. Prüfen Sie Änderungen, bevor Sie sie bestätigen. Bei wiederkehrenden Aufgaben bitten Sie den Assistenten um ein Umplanen statt einer Datumsänderung, sonst geht die Wiederholung verloren. Erteilte Freigaben sehen und entfernen Sie in Todoist unter Einstellungen und Integrationen.

Gehostet: Todoist OAuth im Browser, kein Token nötig. Lokal: persönliches Todoist-API-Token in der Umgebungsvariable TODOIST_API_KEY; alle Werkzeuge laufen dann als dieser Todoist-Nutzer. Erteilte Freigaben sehen und widerrufen Sie in Todoist unter Einstellungen, Integrationen.

Lesen und Schreiben im gesamten Todoist-Konto: Aufgaben, Projekte, Abschnitte, Labels, Filter, Kommentare, Erinnerungen und Zuweisungen. Der Server kann auch Objekte löschen. In Arbeitsbereichen gelten die Rechte des angemeldeten Nutzers.

Beim gehosteten Dienst läuft der Server bei Todoist, lokal auf Ihrem Rechner. Aufgabendaten, die der Assistent liest, gehen an den jeweiligen KI-Anbieter. Laut Todoist gilt für Todoist dessen Datenschutzrichtlinie, für den Assistenten die des jeweiligen Anbieters.

Mittel, weil der Server Aufgaben und Projekte ändern und löschen kann. Ein falsch verstandener Auftrag oder ein präparierter Aufgabentext mit versteckten Anweisungen kann ungewollte Änderungen auslösen. Prüfen Sie schreibende Aktionen vor der Bestätigung. Den lokalen HTTP-Server nicht ohne eigene Zugangskontrolle im Netzwerk freigeben, da er mit Ihrem API-Token arbeitet.