Готовый к производству MCP-сервер, который соединяет AI-ассистентов с вашим экземпляром Nextcloud.

Включите большие языковые модели, такие как Claude, GPT и Gemini, для взаимодействия с вашими данными Nextcloud через защищённый API. Создавайте заметки, управляйте календарями, организуйте контакты, работайте с файлами и многое другое — всё это через разговоры на естественном языке.

Это выделенный автономный MCP-сервер, предназначенный для внешних MCP-клиентов, таких как Claude Code и IDE. Он работает независимо от Nextcloud (Docker, VM, Kubernetes или локально) и обеспечивает глубокие CRUD-операции во всех приложениях Nextcloud.

[! ПРИМЕЧАНИЕ] Хотите использовать функции искусственного интеллекта внутри Nextcloud? Вы можете направить собственный помощник Nextcloud на этот сервер — см. раздел «ИИ внутри Nextcloud» ниже.

[! СОВЕТ] Не хотите самостоятельно хостить? Astrolabe Cloud — это управляемый хостинг для этого MCP-сервера, ориентированный на пользователей и команды, желающие получить продвинутые функции, такие как фоновая синхронизация и семантический поиск, не управляя инфраструктурой самостоятельно. Сервис в настоящее время находится в разработке — зарегистрируйтесь на целевой странице, чтобы присоединиться к списку ранних пользователей.

Быстрый старт

Запустите сервер локально с uvx (установка не требуется):

Nextcloud MCP Server

A production-ready MCP server that connects AI assistants to your Nextcloud instance.

Enable Large Language Models like Claude, GPT, and Gemini to interact with your Nextcloud data through a secure API. Create notes, manage calendars, organize contacts, work with files, and more - all through natural language conversations.

This is a dedicated standalone MCP server designed for external MCP clients like Claude Code and IDEs. It runs independently of Nextcloud (Docker, VM, Kubernetes, or local) and provides deep CRUD operations across Nextcloud apps.

[!NOTE] Want AI features inside Nextcloud instead? You can point Nextcloud’s own Assistant at this server — see AI inside Nextcloud below.

[!TIP] Don’t want to self-host? Astrolabe Cloud is a managed hosting service for this MCP server, aimed at users and teams who want advanced features like background sync and semantic search without operating the infrastructure themselves. The service is currently under development — sign up on the landing page to join the early-adopter list.

Quick Start

Run the server locally with uvx (no installation required):

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

Or add it directly to your MCP client configuration (e.g. claude_desktop_config.json or .claude/settings.json):

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

[!TIP] Generate an app password in Nextcloud under Settings > Security > Devices & sessions instead of using your login password.

Docker

For full features including semantic search, run with Docker:

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

Then connect your MCP client (Claude Desktop, IDEs, mcp dev, etc.) to http://127.0.0.1:8000/mcp.