PROGRESS.md

Nextcloud MCP Server — Development Progress

Current Phase: 3 — Groupware

Completed

• Project scaffold: pyproject.toml, src layout, config, permissions, client (2026-03-20)

• Permission model: read/write/destructive levels with decorator (2026-03-20)

• HTTP client: WebDAV + OCS support with niquests (2026-03-20)

• Files tools: list_directory, get_file, upload_file, create_directory, delete_file, move_file (2026-03-20)

• Users tools: get_current_user, list_users, get_user (2026-03-20)

• Unit tests: permissions, config (2026-03-20)

• Integration tests: files lifecycle, users (2026-03-20)

• CI pipeline: lint + unit tests + integration tests with real Nextcloud (2026-03-20)

• Notifications tools: list_notifications, dismiss_notification, dismiss_all_notifications (2026-03-21)

• Test suite overhaul: MCP tool-level integration tests (2026-03-21)

• Talk tools: list_conversations, get_conversation, get_messages, get_participants, send_message, create_conversation, delete_message, leave_conversation (2026-03-22)

• Talk polls: get_poll, create_poll, vote_poll, close_poll (2026-03-24)

• Activity tools: get_activity (2026-03-24)

• Comments tools: list_comments, add_comment, edit_comment, delete_comment (2026-03-24)

• search_files tool via WebDAV SEARCH (2026-03-24)

• User Status tools: get_user_status, set_user_status, clear_user_status (2026-03-25)

• Users tools: create_user, delete_user (2026-03-25)

• copy_file tool via WebDAV COPY (2026-03-25)

• get_file returns MCP ImageContent for images (PNG, JPEG, GIF, WebP, BMP, SVG) (2026-03-25)

• System Tags tools: list_tags, get_file_tags, create_tag, assign_tag, unassign_tag, delete_tag (2026-03-25)

• Files Sharing tools: list_shares, get_share, create_share, update_share, delete_share (2026-03-26)

• OCS error message extraction: surface Nextcloud error messages instead of generic HTTP codes (2026-03-27)

• Announcement Center tools: list_announcements, create_announcement, delete_announcement (2026-03-27)

• Files Trashbin tools: list_trash, restore_trash_item, empty_trash (2026-03-27)

• Files Versions tools: list_versions, restore_version (2026-03-27)

• Mail tools: list_mail_accounts, list_mailboxes, list_mail_messages, get_mail_message, send_mail (2026-03-28)

• Collectives tools: list_collectives, get_collective_pages, get_collective_page (2026-03-29)

• App Management tools: list_apps, get_app_info, enable_app, disable_app (2026-03-30)

• User-permission integration tests: non-admin error handling validation (2026-03-30)

• Calendar tools: list_calendars, get_events, get_event, create_event, update_event, delete_event (2026-03-30)

• Contacts tools: list_addressbooks, get_contacts, get_contact, create_contact, update_contact, delete_contact (2026-03-31)

In Progress

Blocked

(none)

Next Up

• Tasks, Deck, Notes

Phases

Phase	Focus	Status
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

Module	Tools	Tests
Files	8	47
Users	5	20
Notifications	3	11
Talk	8	48
Talk Polls	4	32
Activity	1	20
Comments	4	29
User Status	3	19
Announcements	3	29
Trashbin	3	22
Versions	2	18
Shares	5	40
System Tags	6	22
Mail	5	29
Collectives	3	22
App Management	4	14
Calendar	6	44
Contacts	6	36
User Permissions	—	15
Server	—	7
Permissions	—	34
Errors	—	16
Client	—	29
Config	—	17
State	—	2
Total	88	622