Skip to main content
Glama
lindenlion

Vikunja MCP Server

by lindenlion

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

Related MCP server: vikunja-mcp

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

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers