AI 어시스턴트를 Nextcloud 인스턴스에 연결하는 운영 준비가 된 MCP 서버입니다.

Claude, GPT, Gemini와 같은 대형 언어 모델을 통해 안전한 API를 통해 Nextcloud 데이터와 상호작용할 수 있도록 활성화하세요. 노트 작성, 캘린더 관리, 연락처 정리, 파일 작업 등 자연어 대화를 통해 모두 가능합니다.

이 서버는 Claude Code와 IDE 같은 외부 MCP 클라이언트용으로 설계된 전용 독립형 MCP 서버입니다. Nextcloud(Docker, VM, Kubernetes, 로컬 등)와 독립적으로 실행되며, Nextcloud 앱 전반에 걸쳐 심층 CRUD 작업을 제공합니다.

[! 참고] Nextcloud 내에 AI 기능을 원하십니까? Nextcloud 자체 어시스턴트를 이 서버에 지정할 수 있습니다 — 아래 Nextcloud 내 AI 관련 내용을 참고하세요.

[! 팁] 자가 호스팅을 원하지 않나요? 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.