vikunja-mcp

Ein Remote-MCP-Server (Model Context Protocol), der Claude mit Ihrer selbst gehosteten Vikunja-Instanz verbindet. Fügen Sie ihn als benutzerdefinierten Connector in Claude.ai hinzu und verwalten Sie Ihre Aufgaben per Konversation.

Verfügbare Tools

Tool	Beschreibung
`list_projects`	Alle Projekte auflisten
`get_project`	Projektdetails abrufen
`create_project`	Ein neues Projekt erstellen
`update_project`	Ein Projekt aktualisieren
`delete_project`	Ein Projekt löschen
`list_tasks`	Aufgaben über alle Projekte hinweg auflisten/filtern/suchen
`get_task`	Aufgabendetails inklusive Kommentaren abrufen
`create_task`	Eine Aufgabe in einem Projekt erstellen
`update_task`	Aufgabeneigenschaften aktualisieren
`delete_task`	Eine Aufgabe löschen
`complete_task`	Eine Aufgabe als erledigt markieren
`reopen_task`	Eine Aufgabe als nicht erledigt markieren
`add_comment`	Einen Kommentar zu einer Aufgabe hinzufügen
`list_labels`	Alle Labels auflisten
`create_label`	Ein neues Label erstellen
`add_label_to_task`	Ein Label an eine Aufgabe anhängen
`remove_label_from_task`	Ein Label von einer Aufgabe entfernen
`weekly_review`	Eine Zusammenfassung des Wochenrückblicks generieren
`get_calendar`	Agenda-Ansicht von Aufgaben mit Fälligkeitsdaten (überfällig + anstehend)
`create_relation`	Zwei Aufgaben verknüpfen (Unteraufgabe, blockierend, geht voraus, zugehörig, …)
`remove_relation`	Eine Beziehung zwischen zwei Aufgaben entfernen

Schnellstart

npm install
npm run build

export VIKUNJA_URL=https://your-vikunja-instance.example.com
export VIKUNJA_TOKEN=your-api-token
export MCP_AUTH_TOKEN=$(openssl rand -hex 32)
export PORT=9090

node build/index.js

Fügen Sie dann Ihren Server als benutzerdefinierten Connector in Claude.ai unter Einstellungen > Connectors hinzu:

https://your-server.example.com/mcp?token=<MCP_AUTH_TOKEN>

Siehe DEPLOY-UBERSPACE.md für eine vollständige Deployment-Anleitung auf Uberspace.

Konfiguration

Variable	Erforderlich	Beschreibung
`VIKUNJA_URL`	Ja	Basis-URL Ihrer Vikunja-Instanz (ohne abschließenden Schrägstrich)
`VIKUNJA_TOKEN`	Ja	API-Token aus den Vikunja-Einstellungen > API-Tokens
`MCP_AUTH_TOKEN`	Empfohlen	Gemeinsames Geheimnis für den `/mcp`-Endpunkt — siehe Auth
`PORT`	Nein	Port, auf dem gelauscht werden soll (Standard: `3000`)

Authentifizierung

Wenn MCP_AUTH_TOKEN gesetzt ist, weist der Server jede Anfrage an /mcp ab, die nicht einen passenden ?token=…-Abfrageparameter enthält, mit einer 401 Unauthorized-Antwort.

Generieren Sie ein starkes Token:

openssl rand -hex 32

Fügen Sie es der Connector-URL in Claude.ai hinzu:

https://your-server.example.com/mcp?token=<your-token>

Wenn MCP_AUTH_TOKEN nicht gesetzt ist, ist der Endpunkt für jeden erreichbar, der ihn erreichen kann — tun Sie dies nur in einem privaten, durch eine Firewall geschützten Netzwerk.

Kalender-Feed

Der Server stellt einen maschinenlesbaren iCal-Feed bereit, den Sie in jeder Kalender-App abonnieren können:

webcal://your-server.example.com/calendar.ics

Er enthält alle offenen Aufgaben sowie Aufgaben, die in den letzten 30 Tagen abgeschlossen wurden und ein Startdatum, Fälligkeitsdatum oder Enddatum haben. Abonnieren Sie ihn einmal und Ihre Kalender-App wird ihn automatisch abrufen.

Architektur

Transport: Streamable HTTP (zustandslos) — der aktuelle MCP-Standard für Remote-Server
Authentifizierung: Abfrageparameter-Token (MCP_AUTH_TOKEN) für den MCP-Endpunkt; Vikunja-API-Token für Upstream-API-Aufrufe
Laufzeit: Node.js + Express
SDK: @modelcontextprotocol/sdk v1.x

Anforderungen

Node.js ≥ 18
Eine selbst gehostete Vikunja-Instanz mit einem API-Token
Eine öffentlich zugängliche URL, damit Claude.ai den Server erreichen kann

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Vikunja MCP Server