Which integrations are available for this server?

Provides tools for interacting with the Nextcloud Notes app via WebDAV, enabling automated management of notes and categories including listing, reading, creating, editing, and deleting content.

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

Download the repository:

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

Configure environment:

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

Open

Set up the Python environment and install the package:
```
uv venv
uv tool install -e .
```

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

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

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

🪟 Windows (PowerShell)

Download the repository:

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

Configure environment:

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

Edit

Set up the Python environment and install the package:
```
uv venv
uv tool install -e .
```

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

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

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

🗂️ Nextcloud WebDAV Notes Tools (12 tools)

Tool	Description
`check_webdav_login`	Check if WebDAV authentication works and return a success/failure message
`ensure_notes_folder_exists`	Ensure the `/Notes` folder exists; create it if missing
`list_uncategorized_notes`	List `.md` notes directly inside `/Notes`, excluding subfolders
`list_categories`	List all category folders inside `/Notes` (directories only)
`list_notes_of_a_category`	List `.md` notes inside a given category folder
`read_note`	Read the full content of a note from `/Notes` or a category folder
`edit_note`	Replace an existing note’s full content with new text
`create_note`	Create a new Markdown note in `/Notes` or a category folder (auto-create folder if needed)
`delete_note`	Delete a note from `/Notes` or a category folder
`rename_note`	Rename a note within `/Notes` or inside a category
`create_category`	Create a new category folder inside `/Notes`
`edit_category`	Rename an existing category inside `/Notes`
`delete_category`	Delete a category and all notes inside it