rncz/nextcloud-notes-mcp-server

Nextcloud Notes MCP Server

This is an unofficial Nextcloud Notes MCP Server for the Nextcloud Notes app that lets a Large Language Model (LLM) do the heavy lifting for your notes.

Simply tell the LLM what to do with your notes — organize, summarize, rewrite, or perform any custom task — and it will execute your instructions automatically.

Features

• 💻 Fully Local Possible – Run the MCP Server and LLM models entirely on your own PC; no cloud needed.
• 🤖 LLM-Powered Note Management – Automate tasks like summarization, categorization, rewriting, or translations.
• 🌐 Nextcloud Integration via WebDAV – Access your notes directly through Nextcloud using the WebDAV protocol.
• ⚡ Boost Productivity – Save time by letting the LLM handle repetitive or complex note tasks.

Sure! Here is an updated version of the Installation section that clearly separates macOS/Linux and Windows steps.

You can copy-paste this into your README:

Installation

🐧 macOS / Linux

1. Download the repository:

   git clone https://github.com/rncz/nextcloud-notes-mcp-server.git
   

2. Configure environment:

   cd nextcloud-notes-mcp-server
   cp env_sample .env
   

   Open .env and enter your Nextcloud WebDAV URL, username, and password.

3. Set up the Python environment and install the package:

   uv venv
   uv tool install -e .
   

4. Add MCP server to your LLM software (example for LM Studio):

   {
     "mcpServers": {
       "nextcloud-notes-mcp": {
         "command": "uvx",
         "args": ["nextcloud-notes-mcp"]
       }
     }
   }
   

5. Test your setup — Use a model with tool calling enabled and ask it to access your notes.

🪟 Windows (PowerShell)

1. Download the repository:

   git clone https://github.com/rncz/nextcloud-notes-mcp-server.git
   

2. Configure environment:

   cd nextcloud-notes-mcp-server
   copy env_sample .env
   

   Edit .env in your text editor and enter your WebDAV URL, username, and password.

3. Set up the Python environment and install the package:

   uv venv
   uv tool install -e .
   

4. Add MCP server to your LLM software (example for LM Studio):

   {
     "mcpServers": {
       "nextcloud-notes-mcp": {
         "command": "uvx",
         "args": ["nextcloud-notes-mcp"]
       }
     }
   }
   

5. Test your setup — Ask the LLM to check WebDAV login.

🗂️ Nextcloud WebDAV Notes Tools (12 tools)