nextcloud-mcp/RESULTS.md

Test Results — nextcloud-mcp

Date: 2026-05-11

Test Environment

• Server: cloud.beatrice.wtf
• User: astro_bea
• Test folder: /__ncmcp_test__/ (created and cleaned up)

Tool Tests

Browsing & Discovery (5 tools)

#	Tool	Test	Result	Notes
1	list_files	Root /	✅	Returns array of files/folders
2	list_files	Empty folder	✅	Returns []
3	list_files	Non-existent folder	✅	Returns 404 error
4	list_files	depth=infinity	✅	Recursive listing works
5	get_file_info	Existing file	✅	Returns extended metadata (owner, hasPreview)
6	get_file_info	Non-existent file	✅	Returns 404 error
7	search_files	By name	✅	Found "hello.txt" in test folder
8	search_files	By mimeType	✅	Found text/plain files
9	search_files	No results	✅	Returns []
10	list_favorites	After set_favorite	✅	Shows favorited files
11	get_quota	Standard	✅	Returns used/available

Read & Download (3 tools)

#	Tool	Test	Result	Notes
12	read_file	UTF-8 text	✅	Returns content with encoding=utf8
13	read_file	Binary (base64)	✅	Auto-detects binary, returns base64
14	download_file	With metadata	✅	Returns downloadUrl + metadata
15	download_file	Without metadata	✅	Returns downloadUrl only
16	download_folder	ZIP format	✅	Returns base64-encoded ZIP

Write & Upload (3 tools)

#	Tool	Test	Result	Notes
17	upload_file	UTF-8 content	✅	Creates file, returns metadata
18	upload_file	Base64 binary	✅	Decodes base64, uploads correctly
19	upload_file	Overwrite	✅	Overwrites existing file
20	create_folder	New folder	✅	Creates folder, returns metadata
21	create_folder	Already exists	✅	Returns "Folder already exists" error
22	create_folder	Parent missing (409)	✅	Returns clear error message
23	bulk_upload	Multiple files	⚠️	Server returns 400 — endpoint may not be supported on this Nextcloud version

Chunked Upload (3 tools)

#	Tool	Test	Result	Notes
24	chunked_upload_start	Start session	✅	Returns uploadId, totalChunks
25	chunked_upload_chunk	Upload chunk	✅	Returns success, uploadedSize
26	chunked_upload_finish	Assemble file	✅	Returns file metadata, content verified

Move, Copy, Delete (3 tools)

#	Tool	Test	Result	Notes
27	move_file	Move to subfolder	✅	File moved, metadata returned
28	copy_file	Copy file	✅	New file created with new fileId
29	move_file	Destination exists (no overwrite)	✅	Returns "Destination already exists" error
30	move_file	Overwrite=true	✅	Overwrites destination
31	delete_file	Delete file	✅	Returns success, file goes to trash

Trashbin (4 tools)

#	Tool	Test	Result	Notes
32	trash_list	List trash	✅	Returns TrashedFile[] with originalName, originalLocation, deletionTime
33	trash_restore	Restore item	✅	Restores to original location
34	trash_delete	Permanent delete	✅	Item removed from trash
35	trash_empty	NOT TESTED	⏭️	Skipped — would empty entire trashbin

Favorites & Versions (3 tools)

#	Tool	Test	Result	Notes
36	set_favorite	Add favorite	✅	favorite=true in metadata
37	set_favorite	Remove favorite	✅	favorite=false in metadata
38	get_file_versions	List versions	✅	Returns version list

Edge Cases

#	Test	Result	Notes
39	Path with spaces	✅	folder with spaces/file with spaces.txt works
40	Special characters (éàü)	✅	file_éàü.txt works
41	Empty folder listing	✅	Returns []
42	File overwrite	✅	PUT overwrites silently
43	Depth=0 (single item)	✅	Returns single-item array

Summary

• 35 tests passed ✅
• 1 test skipped (trash_empty — destructive)
• 1 test failed (bulk_upload — server-side limitation)
• 3 bugs found and fixed during testing (search parsing, trashbin paths, trash restore)

Notes

• Chunked upload requires all steps in the same process (in-memory session map). The CLI wrapper spawns a new process per call, so chunked upload must be tested via programmatic API or within a single MCP session.
• bulk_upload depends on Nextcloud's /remote.php/dav/bulk endpoint which may not be available on all server versions.
• The search_files PROPFIND fallback with depth: infinity on large directories (e.g., root /) may be slow. The WebDAV SEARCH endpoint (when available) is much faster.