Provides LLM-powered management of Nextcloud Notes through WebDAV protocol, enabling automated tasks like organizing, summarizing, rewriting, categorizing, and translating notes.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Nextcloud Notes MCP Server summarize my meeting notes from yesterday"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
💻 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:
Related MCP server: Nextcloud MCP Server
Download the repository:
git clone https://github.com/rncz/nextcloud-notes-mcp-server.gitConfigure environment:
cd nextcloud-notes-mcp-server
cp env_sample .envOpen .env and enter your Nextcloud WebDAV URL, username, and password.
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.
Download the repository:
git clone https://github.com/rncz/nextcloud-notes-mcp-server.gitConfigure environment:
cd nextcloud-notes-mcp-server
copy env_sample .envEdit .env in your text editor and enter your WebDAV URL, username, and password.
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.
Tool | Description |
| Check if WebDAV authentication works and return a success/failure message |
| Ensure the |
| List |
| List all category folders inside |
| List |
| Read the full content of a note from |
| Replace an existing note’s full content with new text |
| Create a new Markdown note in |
| Delete a note from |
| Rename a note within |
| Create a new category folder inside |
| Rename an existing category inside |
| Delete a category and all notes inside it |
Check if WebDAV login is successful. Returns a message indicating success or failure.
Inputs: no named parameters. Returns: result
Create a new category inside Notes by creating a subdirectory.
Inputs: category_name (required). Returns: result
Create a new Markdown (.md) note.
- If category is None → stored in /Notes/<filename>
- If category is provided → stored in /Notes/<category>/<filename>
Inputs: filename (required), content (required), category. Returns: result
Delete a category folder inside Notes.
Inputs: category_name (required). Returns: result
Delete a note file inside Notes.
Inputs: filename (required), category. Returns: result
Rename an existing category inside Notes.
Args:
old_name: Current name of the category.
new_name: New name for the category.
Inputs: old_name (required), new_name (required). Returns: result
Edit a Markdown (.md) file, updating its content. Always overwrites the old file.
Inputs: filename (required), new_content (required), category. Returns: result
Ensure that the /Notes folder exists in Nextcloud. Creates it if it doesn't exist.
Inputs: no named parameters. Returns: result
List all categories (directories) inside /Notes.
Inputs: no named parameters. Returns: result
List all notes in a given category inside /Notes.
Args:
category_name: The subfolder name inside /Notes
Returns:
List of note filenames (.md) in that category.
Inputs: category_name (required). Returns: result
List all Markdown (.md) files directly inside /Notes (not in subfolders).
Inputs: no named parameters. Returns: result
Read a Markdown (.md) file.
Args:
filename: Name of the note file, e.g., "note1.md"
category: Optional category folder. If None, read from /Notes root.
Returns:
Content of the note as a string.
Inputs: filename (required), category. Returns: result
Rename a Markdown (.md) note inside Notes or a category. Overwrites the target if it already exists.
Inputs: filename (required), new_filename (required), category. Returns: result
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 13 tools
Each tool has a distinct purpose with clear boundaries: login check, folder management, note CRUD operations, and listing functions are well-separated. No overlapping functionality exists, making tool selection straightforward for an agent.
All tools follow a consistent verb_noun pattern (e.g., create_note, delete_category, list_notes_of_a_category). The naming is uniform and predictable throughout the set, enhancing readability and usability.
With 13 tools, the server is well-scoped for managing notes and categories in Nextcloud. Each tool serves a specific role in the domain, covering essential operations without bloat or redundancy.
The toolset provides complete coverage for note and category management, including CRUD operations for both, folder setup, login verification, and listing functions. No gaps are apparent, supporting full agent workflows without dead ends.
Notes and actions in one app. Let Claude or ChatGPT read and update them.
Create, search, and update notes in an xNotepad AI notebook, with semantic search and AI Q&A.
Read and write the notes and folders of your Grape account, the AI note-taking app.
Google Keep-style notes app with an MCP server for AI agents to read/write notes.