Vikunja MCP Server
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 |
| Alle Projekte auflisten |
| Projektdetails abrufen |
| Ein neues Projekt erstellen |
| Ein Projekt aktualisieren |
| Ein Projekt löschen |
| Aufgaben über alle Projekte hinweg auflisten/filtern/suchen |
| Aufgabendetails inklusive Kommentaren abrufen |
| Eine Aufgabe in einem Projekt erstellen |
| Aufgabeneigenschaften aktualisieren |
| Eine Aufgabe löschen |
| Eine Aufgabe als erledigt markieren |
| Eine Aufgabe als nicht erledigt markieren |
| Einen Kommentar zu einer Aufgabe hinzufügen |
| Alle Labels auflisten |
| Ein neues Label erstellen |
| Ein Label an eine Aufgabe anhängen |
| Ein Label von einer Aufgabe entfernen |
| Eine Zusammenfassung des Wochenrückblicks generieren |
| Agenda-Ansicht von Aufgaben mit Fälligkeitsdaten (überfällig + anstehend) |
| Zwei Aufgaben verknüpfen (Unteraufgabe, blockierend, geht voraus, zugehörig, …) |
| 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.jsFü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 |
| Ja | Basis-URL Ihrer Vikunja-Instanz (ohne abschließenden Schrägstrich) |
| Ja | API-Token aus den Vikunja-Einstellungen > API-Tokens |
| Empfohlen | Gemeinsames Geheimnis für den |
| Nein | Port, auf dem gelauscht werden soll (Standard: |
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 32Fü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.icsEr 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-AufrufeLaufzeit: Node.js + Express
SDK:
@modelcontextprotocol/sdkv1.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 deployed
Maintenance
Related MCP Connectors
Persistent context for Claude. Your AI always knows your projects and next actions across sessions.
- platform7nOAuthtech.p7n
Connect Claude to your Platform7n workspaces — chat, links, and tasks. One-click OAuth.
Notes and actions in one app. Let Claude or ChatGPT read and update them.
Personal CRM for Claude. Contacts live as plain-text files in your own Google Drive.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables interaction with Vikunja task management instances through natural language. Supports comprehensive project and task operations including CRUD, assignments, labels, comments, relations, and attachments.3344 npm2MIT
- AlicenseCqualityCmaintenanceEnables AI assistants to interact with Vikunja task management via ergonomic and raw REST tools for projects, tasks, labels, and comments.10010 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables to interact with Vikunja task management through its REST API, supporting projects, tasks, comments, labels, assignees, and relations with field preservation.44 npmMIT
- AlicenseCqualityDmaintenanceEnables AI assistants to interact with Vikunja task management instances, providing full task, project, label, and user management capabilities.17141 npmMIT