Add Calendar tools with CalDAV support (#33)

Author: bigcat88

.github/workflows/tests-integration.yml

@@ -230,6 +230,17 @@ jobs:
           docker exec $NC_CONTAINER su -s /bin/bash www-data -c "php occ config:system:set auth.bruteforce.protection.enabled --value=false --type=boolean"
           docker exec $NC_CONTAINER su -s /bin/bash www-data -c "php occ app:install spreed" || echo "spreed already installed"
 
+      - name: Warm up OCS API
+        run: |
+          for i in $(seq 1 10); do
+            if curl -sf -u admin:admin -H "OCS-APIRequest: true" http://localhost:8080/ocs/v2.php/cloud/user > /dev/null 2>&1; then
+              echo "OCS API is ready"
+              break
+            fi
+            echo "Waiting for OCS API... ($i)"
+            sleep 3
+          done
+
       - name: Run user permission tests
         env:
           NEXTCLOUD_URL: http://localhost:8080

PROGRESS.md

@@ -1,6 +1,6 @@
 # Nextcloud MCP Server — Development Progress
 
-## Current Phase: 2 — Communication
+## Current Phase: 3 — Groupware
 
 ### Completed
 - [x] Project scaffold: pyproject.toml, src layout, config, permissions, client (2026-03-20)
@@ -33,23 +33,27 @@
 - [x] Collectives tools: list_collectives, get_collective_pages, get_collective_page (2026-03-29)
 - [x] App Management tools: list_apps, get_app_info, enable_app, disable_app (2026-03-30)
 - [x] User-permission integration tests: non-admin error handling validation (2026-03-30)
+- [x] Calendar tools: list_calendars, get_events, get_event, create_event, update_event, delete_event (2026-03-30)
 
 ### In Progress
 
 ### Blocked
 (none)
 
 ### Next Up
-- Phase 3 — Groupware (Calendar, Contacts, Tasks, Deck, Notes)
+- Contacts, Tasks, Deck, Notes
 
 ## Phases
 
 | Phase | Focus | Status |
 |-------|-------|--------|
-| 1 | Core (Files, Users, Notifications, Activity) | In Progress |
-| 2 | Communication (Talk) | In Progress |
-| 3 | Collaboration (Shares, Calendar, Contacts, Deck) | Not Started |
-| 4 | Advanced (Search, Status, Apps) | Not Started |
+| 1 | Core (Files, Users, Notifications, Activity) | Complete |
+| 2 | Communication (Talk, Announcements, Mail) | Complete |
+| 3 | Groupware (Calendar, Contacts, Tasks, Deck, Notes) | In Progress |
+| 4 | Collaboration (Collectives, Forms, Polls, Tables) | Not Started |
+| 5 | Storage & Search | Not Started |
+| 6 | Media & Data | Not Started |
+| 7 | Advanced & Admin (App Management, etc.) | In Progress |
 
 ## Test Coverage
 
@@ -71,11 +75,12 @@
 | Mail | 5 | 29 |
 | Collectives | 3 | 22 |
 | App Management | 4 | 14 |
+| Calendar | 6 | 44 |
 | User Permissions | — | 15 |
 | Server | — | 7 |
 | Permissions | — | 34 |
 | Errors | — | 16 |
 | Client | — | 29 |
 | Config | — | 17 |
 | State | — | 2 |
-| **Total** | **67** | **542** |
+| **Total** | **73** | **586** |

pyproject.toml

@@ -22,6 +22,7 @@ classifiers = [
   "Programming Language :: Python :: 3.14",
 ]
 dependencies = [
+  "icalendar>=7",
   "mcp[cli]>=1.20",
   "niquests>=3",
 ]
@@ -107,7 +108,8 @@ venv = "venv"
 reportUnusedFunction = false
 reportPrivateUsage = false
 executionEnvironments = [
-  { root = "tests/test_client_retry.py", reportAttributeAccessIssue = false, reportUnknownMemberType = false }
+  { root = "tests/test_client_retry.py", reportAttributeAccessIssue = false, reportUnknownMemberType = false },
+  { root = "src/nc_mcp_server/tools/calendar.py", reportUnknownMemberType = false, reportUnknownVariableType = false, reportUnknownArgumentType = false },
 ]
 
 [tool.pytest]

src/nc_mcp_server/server.py

@@ -10,6 +10,7 @@
     activity,
     announcements,
     app_management,
+    calendar,
     collectives,
     comments,
     files,
@@ -53,6 +54,7 @@ def create_server(config: Config | None = None) -> FastMCP:
     activity.register(mcp)
     announcements.register(mcp)
     app_management.register(mcp)
+    calendar.register(mcp)
     collectives.register(mcp)
     comments.register(mcp)
     files.register(mcp)