Todoist MCP einrichten: OAuth, Projekte und Aufgaben
Verbinden Sie Todoist und prüfen Sie zuerst eine bekannte Aufgabe im richtigen Projekt.
Wählen Sie in Todoist eine bereits vorhandene Testaufgabe. Notieren Sie ihren Titel, das Projekt und die angezeigte Fälligkeit. Falls ein Datum mit Uhrzeit vorkommt, halten Sie auch die Zeitzone fest. So können Sie später zwischen einem Verbindungsproblem, einer zu engen Suche und einer unterschiedlich dargestellten Zeit unterscheiden.
HTTP oder lokalen Prozess wählen
Doist dokumentiert den gehosteten MCP-Endpunkt https://ai.todoist.net/mcp mit Streamable HTTP und OAuth. Das ist der hier beschriebene Weg. Daneben gibt es das lokale Paket @doist/todoist-mcp, das einen API-Schlüssel über TODOIST_API_KEY erwartet. Beide Wege verbinden sich mit Todoist; sie haben unterschiedliche Anmelde- und Laufzeitvoraussetzungen.
Die Verbindung in VS Code anlegen
Öffnen Sie „MCP: Add Server“, wählen Sie HTTP und geben Sie den folgenden Endpunkt ein. Wenn Sie bereits das VS-Code-Format verwenden, gehört dieser vollständige Eintrag in .vscode/mcp.json. Ein vorhandener gleichnamiger Eintrag sollte ersetzt werden, damit nicht zwei Verbindungen mit verschiedenen Konten nebeneinander laufen.
{
"servers": {
"todoist": {
"type": "http",
"url": "https://ai.todoist.net/mcp"
}
}
}
Starten Sie den Server im Client und schließen Sie die OAuth-Anmeldung im Browser mit dem vorgesehenen Todoist-Konto ab. Der gehostete Weg braucht keinen API-Schlüssel in der Projektdatei. Die Einrichtungsanleitung für VS Code erklärt weitere Dateiformate. Prüfen Sie nach der Anmeldung die tatsächlich angebotenen Werkzeuge, bevor Sie einen Auftrag ausführen.
Eine Aufgabe lesen und vergleichen
Wählen Sie eine lesende Funktion aus der Werkzeugliste. Geben Sie den Projektnamen und den exakten Titel der vorbereiteten Aufgabe an.
Vergleichen Sie Aufgabenkennung und Projekt mit der Todoist-Oberfläche. Ein ähnlicher Titel aus einem anderen Projekt ist kein passender Treffer.
Prüfen Sie Fälligkeitsdatum, Uhrzeit und Zeitzone getrennt. Beginnen Sie bei einem leeren Zeitfilter mit der direkten Suche nach der bekannten Aufgabe.
Notieren Sie Ergebnis und Zeitpunkt. Wiederholen Sie denselben Abruf nach einem Neustart, bevor Sie eine regelmäßige Nutzung einplanen.
Leere Antworten und Abbrüche einordnen
| Beobachtung | Prüfung |
|---|---|
| Anmeldung scheitert | Serveradresse, verwendetes Konto und den OAuth-Abschluss im Client prüfen. |
| Aufgabe fehlt | Projekt und Titel direkt vergleichen; Zeitfilter zunächst weglassen. |
| Datum scheint verschoben | Datum ohne Uhrzeit von einem Zeitpunkt unterscheiden und die Zeitzone abgleichen. |
| Eine Sitzung bricht ab | Verbindung im Client erneut herstellen und den gleichen Lesetest wiederholen. |
Der erste Versuch soll nichts erstellen, erledigen oder verschieben. Diese Handlungen sind eigene Arbeitsschritte mit anderen Folgen. Ein Auftrag, nur zu lesen, ist allerdings keine technische Beschränkung der Kontorechte. Halten Sie deshalb im Zugriffsplan fest, welche Werkzeuge freigegeben sind. Die Todoist-Registersuche hilft beim Abgleich von Anbieter, Paket und Quelle. Verwenden Sie einen Wechsel auf ein lokales Paket nicht als automatische Lösung für jedes Anmeldeproblem: Prüfen Sie dessen dokumentierte Laufzeit und Schlüsselübergabe gesondert.
- Brauche ich für den HTTP-Weg einen API-Schlüssel?
- Der beschriebene gehostete Weg verwendet OAuth. Der API-Schlüssel gehört zum separat dokumentierten lokalen Paketweg und ist hier nicht Teil der JSON-Datei.
- Warum finde ich eine Aufgabe ohne Datumsfilter, aber nicht mit Filter?
- Vergleichen Sie den genauen Zeitraum und die Darstellung der Fälligkeit. Prüfen Sie denselben Datensatz in Todoist, bevor Sie einen Fehler der Verbindung annehmen.
- Darf ich eine Aufgabe als Verbindungstest erledigen?
- Beginnen Sie mit einem Lesetest. Eine Erledigung verändert den Aufgabenstatus und kann den weiteren Arbeitsablauf beeinflussen; sie gehört in einen ausdrücklich vorgesehenen Änderungstest.
- Was dokumentiere ich für einen wiederholbaren Test?
- Konto, Projektkennung, Aufgabenkennung, Filter, Zeitpunkt und erwartete Felder. Speichern Sie diese Notiz getrennt von Zugangsdaten und begrenzen Sie enthaltene persönliche Informationen.
Weitere Projektwerkzeuge stehen in der App-Auswahl.
Herstellerdokumentation am 2. Oktober 2026 geprüft. Die Prüfschritte sind ein Vorschlag für Ihre Umgebung, kein angemeldeter Kontotest.
- Doist: Todoist MCP
Abrufbefehl anzeigen
curl -s https://github.com/Doist/todoist-mcp - Doist: MCP server setup
Abrufbefehl anzeigen
curl -s https://github.com/Doist/todoist-mcp/blob/main/docs/mcp-server.md - VS Code: MCP configuration
Abrufbefehl anzeigen
curl -s https://code.visualstudio.com/docs/agent-customization/mcp-servers