nextcloud-mcp-server

Overview

Nextcloud MCP Server is a robust, standalone implementation that enables Claude, GPT, and Gemini to interact with Nextcloud through natural language. It supports comprehensive CRUD operations across multiple Nextcloud applications including Notes, Calendar, Contacts, Files, Deck, Cookbook, Tables, and more. The server offers multiple deployment options including Docker, Kubernetes, and local installations with both stdio and HTTP transport protocols.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• create_note

  Create a new note in Nextcloud

  Try:Create a new note titled 'Meeting Notes'Try:Add a new note with content about my project
• list_events

  List calendar events from Nextcloud

  Try:Show me my calendar events for todayTry:List all upcoming appointments
• create_contact

  Create a new contact in Nextcloud

  Try:Add a new contact with name John DoeTry:Create a contact for my colleague Sarah
• list_files

  List files in Nextcloud directory

  Try:Show me files in Documents folderTry:List all PDF files in my home directory
• create_deck_board

  Create a new board in Nextcloud Deck

  Try:Create a new board called 'Project Tasks'Try:Add a board for my team's planning
• create_recipe

  Create a new recipe in Nextcloud Cookbook

  Try:Add a recipe for chocolate chip cookiesTry:Create a new recipe from this URL
• add_table_row

  Add a row to a Nextcloud Table

  Try:Add a new row to my expenses tableTry:Insert a row with customer information
• create_share

  Create a share for Nextcloud files or resources

  Try:Share my presentation with my teamTry:Create a read-only link for the document
• list_news_feeds

  List news feeds in Nextcloud News

  Try:Show me my subscribed news feedsTry:List all unread news items
• create_collective

  Create a new collective in Nextcloud Collectives

  Try:Create a new collective called 'Documentation'Try:Add a collective for team meeting notes
• list_talk_conversations

  List conversations in Nextcloud Talk

  Try:Show me my chat conversationsTry:List all unread messages
• semantic_search

  Perform semantic search across Nextcloud content

  Try:Find documents related to my projectTry:Search for notes about the meeting

Comparable tools

Installation

NEXTCLOUD_HOST=https://your.nextcloud.instance.com \
NEXTCLOUD_USERNAME=your_username \
NEXTCLOUD_PASSWORD=your_app_password \
  uvx nextcloud-mcp-server run --transport stdio

{
  "mcpServers": {
    "nextcloud": {
      "command": "uvx",
      "args": ["nextcloud-mcp-server", "run", "--transport", "stdio"],
      "env": {
        "NEXTCLOUD_HOST": "https://your.nextcloud.instance.com",
        "NEXTCLOUD_USERNAME": "your_username",
        "NEXTCLOUD_PASSWORD": "your_app_password"
      }
    }
  }
}

docker run -p 127.0.0.1:8000:8000 --rm \
  -e NEXTCLOUD_HOST=https://your.nextcloud.instance.com \
  -e NEXTCLOUD_USERNAME=your_username \
  -e NEXTCLOUD_PASSWORD=your_app_password \
  ghcr.io/cbcoutinho/nextcloud-mcp-server:latest

FAQ

How do I generate authentication credentials for Nextcloud?

Create an app password in Nextcloud under Settings > Security > Devices & sessions instead of using your login password. This provides secure access without exposing your main credentials.

Does this MCP server support multi-user environments?

Yes, it supports three authentication modes: Single-User (BasicAuth), Multi-User (BasicAuth pass-through), and Multi-User (Login Flow v2) for OAuth-based authentication with per-user app password handling.

Compare nextcloud-mcp-server with