# Nextcloud Notes MCP Server
**Nextcloud Notes MCP Server** is a 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.
## Installation
1. **Download the repository**:
```bash
git clone https://github.com/rncz/nextcloud-notes-mcp-server.git
```
2. **Configure environment**:
* Change into the project directory:
```bash
cd nextcloud-notes-mcp-server
```
* Copy the sample environment file and edit credentials:
```bash
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**:
```bash
uv venv
uv tool install -e .
```
4. **Add MCP server to your LLM software** (example for LM Studio):
Edit your MCP JSON configuration:
```json
{
"mcpServers": {
"nextcloud-notes-mcp": {
"command": "uvx",
"args": [
"nextcloud-notes-mcp"
]
}
}
}
```
5. **Test your setup**:
* Use a model with **tool calling** enabled.
* Ask the model to access your notes and verify if the login is successful.
Good luck playing around with your Nextcloud Notes!