This Nextcloud Notes MCP Server lets your Nextcloud Notes app be managed by a local Large Language Model (LLM). You install the server, connect it to your LLM tool, and instruct the LLM to organize, summarize, rewrite, or perform custom tasks on your notes—all running locally for privacy and speed.

How to use

You interact with the MCP server through your preferred MCP client. Add the server as a local endpoint, then enable tool calling in your LLM to let the model perform operations on your notes. Typical workflows include listing notes by category, creating new notes, reading and editing existing notes, and applying transformations like summarization or reorganization. The server exposes a set of tools for managing your /Notes folder via WebDAV so your client can perform tasks directly on your notes.

How to install

Prerequisites you need before installation include Python and a runtime CLI for MCP servers. You will run a local MCP instance and connect it to your LLM tooling.

macOS / Linux installation steps

# Step 1: Clone the project
git clone https://github.com/rncz/nextcloud-notes-mcp-server.git

# Step 2: Configure environment
cd nextcloud-notes-mcp-server
cp env_sample .env
# Open .env and enter your Nextcloud WebDAV URL, username, and password

# Step 3: Set up Python environment and install the package
uv venv
uv tool install -e .

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

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

Step 5: Test your setup

Use a model with tool calling enabled and ask it to access your notes

## Windows (PowerShell) installation steps

Windows users install with PowerShell steps that mirror the macOS/Linux flow, adjusting file paths as needed.

Step 1: Clone the project

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

Step 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

Step 3: Set up Python environment and install the package

uv venv uv tool install -e .

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

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

# Step 5: Test your setup
# Ask the LLM to check WebDAV login

Nextcloud WebDAV Notes Tools

The server exposes a set of 12 tools that interact with your Nextcloud Notes via WebDAV. You will use these tools to manage folders and notes directly from your LLM workflows.

Available tools

check_webdav_login

Verify WebDAV access by attempting to log in and return success or failure.

ensure_notes_folder_exists

Create the /Notes folder if it does not already exist.

list_uncategorized_notes

List all .md note files directly under /Notes, excluding subfolders.

list_categories

List all category folders inside /Notes (directories only).

list_notes_of_a_category

List .md notes inside a specified 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 (creates folders if needed).

delete_note

Delete a note from /Notes or a category folder.

rename_note

Rename a note within /Notes or inside a category folder.

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.