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:

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

2. Configure environment:

   • Change into the project directory:

     cd nextcloud-notes-mcp-server
     

   • Copy the sample environment file and edit credentials:

     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:

   uv venv
   uv tool install -e .
   

4. Add MCP server to your LLM software (example for LM Studio): Edit your MCP JSON configuration:

   {
     "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!