Nextcloudmcp

@bizneto

4 months ago

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 monitoring capabilities.

Overview Tools Comments

Overview

Nextcloud MCP Server - Overview

🎯 What is Nextcloud MCP Server?

The Nextcloud MCP Server is a comprehensive Model Context Protocol (MCP) implementation that bridges AI agents (like Claude) with Nextcloud cloud storage platforms. It provides secure, programmatic access to Nextcloud's full ecosystem through a standardized interface.

🏗️ Architecture

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Claude AI     │◄──►│  MCP Server     │◄──►│   Nextcloud     │
│   Assistant     │    │  (This Project) │    │   Instance      │
└─────────────────┘    └─────────────────┘    └─────────────────┘

Core Components

MCP Server: Translates AI requests into Nextcloud API calls
Nextcloud Client: Handles authentication and API communication
Tool System: 37 specialized tools across 7 categories
Resource System: 6 dynamic resources for real-time data access
Prompt System: 5 workflow templates for complex operations

🛠️ Tool Categories (37 Total)

File Management (7 Tools)

Complete WebDAV operations: list, upload, download, delete, move, copy, create folders

Full share lifecycle: create, list, update, delete shares with permissions and passwords

User Administration (7 Tools)

Complete user management: create, read, update, delete, enable/disable users (admin required)

Group Management (6 Tools)

Group operations: create, delete, list groups, manage memberships (admin required)

System Monitoring (3 Tools)

Server health: status, capabilities, connection testing

Comments System (3 Tools)

File comments: list, add, delete comments on files

Local File Management (5 Tools)

Efficient file processing: download to local cache, process, upload back

Activity Monitoring (2 Tools)

Track activities: file operations, shares, user actions, security events

📊 Resources System (6 Resources)

Dynamic resources provide real-time access to Nextcloud data:

nextcloud://files - Root directory listing
nextcloud://shares - All shares overview
nextcloud://users - User directory
nextcloud://groups - Group listing
nextcloud://status - Server status
nextcloud://capabilities - Server capabilities

Try in Playground

Server Config

{
  "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-password-or-app-password"
      }
    }
  }
}

Build with ShipAny.