todoist-mcp

Funktionen

• Vollständige Todoist API-Integration: Zugriff auf die vollständige Todoist REST API v2 und Unterstützung für die Todoist Sync API durch natürliche Sprache

• Stapelverarbeitung: Der Client kann mehrere Aufgaben in einer einzigen Anfrage verarbeiten

• Suche nach Namen: Die KI kann nach Aufgaben, Projekten und Labels anhand ihres Namens statt ihrer ID suchen

• Aufgaben: Erstellen, aktualisieren, abschließen, wieder öffnen, verschieben und löschen von Aufgaben mithilfe von Konversationssprache

• Projekte: Erstellen und verwalten von Projekten und Abschnitten

• Kommentare: Hinzufügen und verwalten von Kommentaren zu Aufgaben und Projekten

• Labels: Erstellen und verwalten von persönlichen und geteilten Labels

• Prompt-Unterstützung: Sie können dem Client problemlos Informationen über Ihre Projekte bereitstellen

Related MCP server: Notion API MCP Server

Konfiguration

Sie benötigen ein Todoist API-Token, um diesen MCP-Server zu verwenden.

Abrufen eines Todoist API-Tokens

1. Melden Sie sich bei Ihrem Todoist-Konto an

2. Navigieren Sie zu Einstellungen → Integrationen

3. Finden Sie Ihr API-Token unter "Entwickler"

Verwendung

Fügen Sie dies zu mcpServers in Ihrer Plattform-Konfiguration hinzu:

"todoist": {
    "command": "npx",
    "args": ["-y", "todoist-mcp"],
    "env": { "API_KEY": "your_todoist_api_token" }
}

Codex — CLI:

codex mcp add todoist --env API_KEY=your_token -- npx -y todoist-mcp

Oder fügen Sie es zu config.toml hinzu:

[mcp_servers.todoist]
command = "npx"
args = ["-y", "todoist-mcp"]

[mcp_servers.todoist.env]
API_KEY = "your_todoist_api_token"

Verfügbare Tools

Aufgaben

• get_tasks_list: Abrufen von Aufgaben mit optionaler Filterung nach Projekt, Abschnitt, Label oder IDs

• get_tasks_by_filter: Abrufen von Aufgaben mithilfe der Todoist-Filtersprache (z. B. "today", "overdue", "P1 | P2", "#Work & @urgent")

• create_tasks: Erstellen neuer Aufgaben mit verschiedenen Attributen

• get_tasks: Abrufen spezifischer Aufgaben nach ID oder Name

• update_tasks: Aktualisieren bestehender Aufgaben

• close_tasks: Aufgaben als erledigt markieren

• reopen_tasks: Erledigte Aufgaben wieder öffnen

• delete_tasks: Aufgaben löschen

• move_tasks: Aufgaben in ein anderes Projekt oder einen anderen Abschnitt verschieben

Projekte

• get_projects_list: Alle Projekte abrufen

• create_projects: Neue Projekte erstellen

• get_projects: Spezifische Projekte nach ID oder Name abrufen

• update_projects: Bestehende Projekte aktualisieren

• delete_projects: Projekte löschen

• get_collaborators: Alle Mitarbeiter eines Projekts abrufen

• move_projects: Projekte an einen anderen Ort oder in ein Unterprojekt verschieben

Abschnitte

• get_sections_list: Alle Abschnitte abrufen oder nach Projekt filtern

• create_sections: Neue Abschnitte erstellen

• get_sections: Spezifische Abschnitte nach ID oder Name abrufen

• update_sections: Abschnitte aktualisieren

• delete_sections: Abschnitte löschen

Kommentare

• get_comments_list: Kommentare für ein Projekt oder eine Aufgabe abrufen

• create_comments: Neue Kommentare erstellen

• get_comments: Spezifische Kommentare nach ID abrufen

• update_comments: Kommentare aktualisieren

• delete_comments: Kommentare löschen

Labels

• get_labels_list: Alle persönlichen Labels abrufen

• create_labels: Neue persönliche Labels erstellen

• get_labels: Persönliche Labels nach ID oder Name abrufen

• update_labels: Persönliche Labels aktualisieren

• delete_labels: Persönliche Labels löschen

• get_shared_labels: Alle geteilten Labels abrufen

• rename_shared_labels: Geteilte Labels umbenennen

• remove_shared_labels: Geteilte Labels entfernen

Dienstprogramme

• utils_get_colors: Verfügbare Farben für Projekte, Labels und Filter abrufen

Prompts

• projects_list: Liste der Projekte mit ihren Abschnitten und Parametern im Markdown-Format abrufen

Anwendungsbeispiel

Stellen Sie Ihrem KI-Assistenten (wie Claude) Fragen wie:

"What tasks do I have due today?"
"Create a task to review the quarterly report by next Friday"
"Make a new project called 'Home Renovation'"
"Add a comment to my meeting prep task"
"Show me all my high priority tasks"
"Create a label for 'Urgent' tasks with a red color"
"What projects do I have in my Todoist?"
"Mark my dentist appointment task as complete"

Entwicklung

# Install dependencies
npm install

# Build the project and run inspector
npm run build && npx @modelcontextprotocol/inspector -e API_KEY=YOUR_API_KEY_HERE node dist/index.js

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert - siehe die Datei LICENSE für Details.

Probleme und Support

Wenn Sie auf Probleme stoßen oder Unterstützung benötigen, erstellen Sie bitte ein Issue im GitHub-Repository.