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

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

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)