Nextcloudmcp MCP Server

A comprehensive Model Context Protocol (MCP) server for Nextcloud integration, providing AI agents with secure access to Nextcloud's file management, sharing, user administration, and system…

Local serverstdioMIT

What is the Nextcloudmcp MCP Server?

Nextcloudmcp is an MCP project maintained in the bizneto/nextcloudmcp repository. The maintainer describes its purpose as “A comprehensive Model Context Protocol (MCP) server for Nextcloud integration, providing AI agents with secure access to Nextcloud's file management, sharing, user administration, and system…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using node. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares NEXTCLOUD_URL, NEXTCLOUD_USERNAME, NEXTCLOUD_PASSWORD. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
nextcloud_list_filesList files and folders
nextcloud_upload_fileUpload files to Nextcloud
nextcloud_download_fileDownload files from Nextcloud
nextcloud_delete_fileDelete files or folders
nextcloud_move_fileMove or rename files/folders
nextcloud_copy_fileCopy files or folders
nextcloud_create_folderCreate new folders
nextcloud_list_sharesList all shares
nextcloud_create_shareCreate new shares
nextcloud_update_shareUpdate existing shares
nextcloud_delete_shareDelete shares
nextcloud_list_usersList all users
nextcloud_get_userGet user details
nextcloud_create_userCreate new users
nextcloud_update_userUpdate user information
nextcloud_delete_userDelete users
nextcloud_enable_userEnable disabled user accounts ⭐ NEW
nextcloud_disable_userDisable user accounts (preserves data) ⭐ NEW
nextcloud_list_groupsList all groups
nextcloud_create_groupCreate new groups
nextcloud_delete_groupDelete groups ⭐ NEW
nextcloud_add_user_to_groupAdd users to groups
nextcloud_remove_user_from_groupRemove users from groups
nextcloud_get_group_usersGet all users in a group ⭐ NEW
nextcloud_get_server_statusGet server status
nextcloud_get_capabilitiesGet server capabilities
nextcloud_test_connectionTest connection and verify credentials
nextcloud_list_commentsList comments for a file
nextcloud_add_commentAdd comment to a file
nextcloud_delete_commentDelete a comment from a file
nextcloud_download_to_localDownload files to local folder for direct Claude access
nextcloud_list_local_filesList files in local downloads folder
nextcloud_delete_local_fileDelete files from local folder
nextcloud_upload_from_localUpload files from local folder to Nextcloud
nextcloud_get_downloads_pathGet path to downloads folder
nextcloud_list_activitiesList recent activities (uploads, shares, downloads, etc.)
nextcloud_get_activity_typesGet available activity types and filters

How to install the Nextcloudmcp MCP Server

{
  "mcpServers": {
    "nextcloud": {
      "command": "node",
      "args": [
        "/path/to/nextcloud-mcp-server/dist/index.js"
      ],
      "env": {
        "NEXTCLOUD_URL": "https://your-nextcloud-server.com",
        "NEXTCLOUD_USERNAME": "your-username",
        "NEXTCLOUD_PASSWORD": "YOUR_NEXTCLOUD_PASSWORD"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
NEXTCLOUD_URLDeclared in the maintainer’s client configuration.Check documentation
NEXTCLOUD_USERNAMEDeclared in the maintainer’s client configuration.Check documentation
NEXTCLOUD_PASSWORDDeclared in the maintainer’s client configuration.Check documentation