MCP Nextcloud-Kalender

Ein Model Context Protocol (MCP)-Server für die Nextcloud-Kalenderintegration.

Merkmale

Kalender aus Nextcloud holen
ADHS-freundliche Organisationsfunktionen
MCP-Protokollunterstützung (Streamable HTTP und Legacy HTTP+SSE)

Verwendung

Verwendung mit npx

Am einfachsten lässt sich dieses Paket mit npx verwenden:

npx mcp-nextcloud-calendar

Installation

Für die Entwicklung oder lokale Installation:

# Install globally npm install -g mcp-nextcloud-calendar # Or install locally npm install mcp-nextcloud-calendar

MCP-Client-Konfiguration

Zur Verwendung mit einem MCP-Client (wie Claude) fügen Sie diese Konfiguration zu Ihren MCP-Clienteinstellungen hinzu:

{ "mcpServers": { "nextcloud-calendar": { "command": "npx", "args": ["-y", "mcp-nextcloud-calendar"], "env": { "NEXTCLOUD_BASE_URL": "https://your-nextcloud-server.com", "NEXTCLOUD_USERNAME": "your-username", "NEXTCLOUD_APP_TOKEN": "your-app-token" } } } }

Angeben einer Version

Sie können eine bestimmte Version des Pakets anheften:

{ "mcpServers": { "nextcloud-calendar": { "command": "npx", "args": ["-y", "mcp-nextcloud-calendar@0.1.0"], "env": { "NEXTCLOUD_BASE_URL": "https://your-nextcloud-server.com", "NEXTCLOUD_USERNAME": "your-username", "NEXTCLOUD_APP_TOKEN": "your-app-token" } } } }

Konfiguration

Umgebungsvariablen

Der Server verwendet diese Umgebungsvariablen, wenn möglich mit Standardwerten:

Variable	Beschreibung	Standard	Erforderlich
HAFEN	Server-Port	3001	NEIN
SERVERNAME	MCP-Serverkennung	Nextcloud-Kalender-Server	NEIN
NODE_ENV	Umgebung (Entwicklung/Produktion)	Entwicklung	NEIN
NEXTCLOUD_BASE_URL	Ihre Nextcloud-Server-URL	-	Ja
NEXTCLOUD_USERNAME	Ihr Nextcloud-Benutzername	-	Ja
NEXTCLOUD_APP_TOKEN	Ihr Nextcloud-App-Token	-	Ja
KEEP_ALIVE_INTERVALL	Keep-Alive-Intervall (ms)	30000	NEIN

Entwicklungs-Setup

Für die lokale Entwicklung:

Klonen Sie das Repository
Installieren Sie Abhängigkeiten:

npm install

Erstellen Sie eine .env Datei im Projektstammverzeichnis:

cp .env.example .env

Bearbeiten Sie die .env Datei mit Ihren Nextcloud-Anmeldeinformationen.

Erhalten eines Nextcloud-App-Tokens

Melden Sie sich bei Ihrer Nextcloud-Instanz an
Gehen Sie zu Einstellungen → Sicherheit → App-Passwörter
Erstellen Sie ein neues App-Passwort mit einem Namen wie „MCP-Kalender“
Kopieren Sie das generierte Token in Ihre .env Datei

Entwicklung

# Build the project npm run build # Run in development mode npm run dev # Run tests npm run test # Run linting npm run lint # Format code npm run format

API-Endpunkte

/mcp – Primärer MCP-Endpunkt (Streamabler HTTP-Transport)
/sse und /messages – Legacy-MCP-Endpunkte (HTTP+SSE-Transport)
GET /health – Endpunkt für die Integritätsprüfung
GET /api/calendars - Alle Kalender auflisten

MCP-Tools

Die folgenden MCP-Tools sind registriert und für Kunden verfügbar:

Kalenderverwaltung

Werkzeug	Beschreibung	Parameter
`listCalendars`	Ruft alle verfügbaren Kalender ab	Keiner
`createCalendar`	Erstellt einen neuen Kalender	`displayName` (erforderlich), `color` (optional), `category` (optional), `focusPriority` (optional)
`updateCalendar`	Aktualisiert einen vorhandenen Kalender	`id` (erforderlich), `displayName` (optional), `color` (optional), `category` (optional), `focusPriority` (optional)
`deleteCalendar`	Löscht einen Kalender	`id` (erforderlich)

⚠️ Berechtigungswarnung : Die Tools updateCalendar und deleteCalendar erfordern möglicherweise spezielle Berechtigungen in Ihrer Nextcloud-Instanz. Kalendervorgänge unterliegen dem Berechtigungssystem von Nextcloud.

Veranstaltungsmanagement

Werkzeug	Beschreibung	Parameter
`listEvents`	Ruft Ereignisse für einen Kalender ab	`calendarId` (erforderlich), `start` (optional), `end` (optional)
`getEvent`	Ruft ein bestimmtes Ereignis ab	`calendarId` (erforderlich), `eventId` (erforderlich)
`createEvent`	Erstellt ein neues Ereignis	`calendarId` (erforderlich), `summary` (erforderlich), `start` (erforderlich), `end` (erforderlich), `description` (optional), `location` (optional)
`updateEvent`	Aktualisiert ein vorhandenes Ereignis	`calendarId` (erforderlich), `eventId` (erforderlich), [plus alle zu aktualisierenden Ereigniseigenschaften]
`deleteEvent`	Löscht ein Ereignis	`calendarId` (erforderlich), `eventId` (erforderlich)

Bekannte Probleme und Einschränkungen

Hinweis : Dieses Paket befindet sich derzeit in der frühen Entwicklungsphase (0.1.x). APIs und Tools können sich in zukünftigen Versionen ohne vorherige Ankündigung ändern.

Für die Aktualisierungs- und Löschvorgänge im Kalender sind möglicherweise bestimmte Berechtigungen in Ihrer Nextcloud-Instanz erforderlich.
Die Fehlerbehandlung für bestimmte Nextcloud-Fehlercodes wird noch verbessert
Bei großen Kalendern mit vielen Ereignissen kann es zu Leistungsproblemen kommen

Bitte melden Sie alle Probleme im GitHub-Repository.

Lizenz

ISC

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

mcp-nextcloud-Kalender

Related MCP Servers

Python notebook mcp
UsamaK98
-
security
A
license
-
quality
Python notebook mcp
Last updated -
39
MIT License
mcp-server-cloudbrowser
clpublic
-
security
F
license
-
quality
mcp-server-cloudbrowser
Last updated -
calendar-mcp
deciduus
-
security
F
license
-
quality
calendar-mcp
Last updated -
16
weather-mcp-server
sjanaX01
-
security
A
license
-
quality
weather-mcp-server
Last updated -
16
MIT License

View all related MCP servers

mcp-nextcloud-calendar