Skip to main content
Glama
TheNovaNodes

nextcloud-mcp-gateway

by TheNovaNodes

nextcloud-mcp-gateway ☁️

Python 3.10+ License: MIT MCP Server Nextcloud [Status: Active]

About

High-performance Model Context Protocol (MCP) Data Plane server for Nextcloud integration (TheNovaNodes/nextcloud-mcp-gateway). Enables AI agents to read, write, organize, and manage user files, documentation, reports, and CRM assets over WebDAV and Nextcloud OCS REST API.


Related MCP server: mcp-dev-tools

Exposed MCP Tools

Tool

Parameters

Description

list_files

path: str = "/"

Lists files and directories with timestamps, sizes, and MIME types via WebDAV PROPFIND.

read_file

path: str

Reads textual or markdown document content directly from Nextcloud storage.

write_file

path: str, content: str

Creates or updates user files in Nextcloud storage via WebDAV PUT.

delete_file

path: str

Deletes files or folders from storage via WebDAV DELETE.

create_folder

path: str

Creates new directory structures in Nextcloud storage via WebDAV MKCOL.

get_user_info

None

Retrieves user storage quota, display name, and details via OCS API.

nextcloud_health

None

Runs diagnostic health checks on /status.php and WebDAV availability.


Installation & Setup

# Clone repository
git clone https://github.com/TheNovaNodes/nextcloud-mcp-gateway.git
cd nextcloud-mcp-gateway

# Install in editable mode
pip install -e .

Configuration

Copy .env.example to .env and fill in credentials:

cp .env.example .env

Variable

Description

Default

NC_URL

Local Nextcloud instance endpoint

http://127.0.0.1:8080

NC_PUBLIC_URL

Public HTTPS domain endpoint

https://nc.shtab-ai.ru

NC_USER

Nextcloud username

zavlab

NC_APP_PASSWORD

Nextcloud App Password or WebDAV token

Required

NC_TIMEOUT

Request timeout in seconds

30


MCP Client Integration

Add to your MCP configuration (mcp_config.json or claude_desktop_config.json):

{
  "mcpServers": {
    "nextcloud-gateway": {
      "command": "python3",
      "args": ["-m", "nextcloud_mcp_gateway.server"],
      "cwd": "/home/ddoctorm/projects/TheNovaNodes/nextcloud-mcp-gateway",
      "env": {
        "NC_URL": "http://127.0.0.1:8080",
        "NC_PUBLIC_URL": "https://nc.shtab-ai.ru",
        "NC_USER": "zavlab",
        "NC_APP_PASSWORD": "your_app_password"
      }
    }
  }
}

Running Unit Tests

python3 -m pytest -v

License

MIT — See LICENSE file.

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.

  • OCR, transcription, file extraction, and image generation for AI agents via MCP.

  • Cloud-hosted MCP server for durable AI memory

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/TheNovaNodes/nextcloud-mcp-gateway'

If you have feedback or need assistance with the MCP directory API, please join our Discord server