
cbcoutinho/nextcloud-mcp-server
Deployment & DevOpsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
Nextcloud MCP Server
概要
Claude、GPT、Geminiなどの大規模言語モデルを安全なAPIを通じてNextcloudのデータとやり取りできるようにします。ノート作成、カレンダー管理、連絡先の整理、ファイルの管理など、すべて自然言語の会話を通じて行えます。 これはClaude CodeやIDEのような外部MCPクライアント向けに設計されています。Nextcloud(Docker、VM、Kubernetes、ローカル)とは独立して動作し、Nextcloudアプリ間で深いCRUD操作を提供します。 NextcloudはContext Agentも提供しており、Assistantアプリを動かし、Nextcloud内でExAppとして動作します。詳細なユースケース比較についてはdocs/comparison-context-agent.mdをご覧ください。 Astrolabe Cloudは、このMCPサーバー向けのマネージドホスティングサービスであり、バックグラウンド同期やセマンティックサーチなどの高度な機能を求めるユーザーやチーム向けに、インフラを自ら操作せずに提供しています。このサービスは現在開発中です。早期導入者リストに参加するにはランディングページで登録してください。
概要(AI 翻訳)
本番環境に対応したMCPサーバーで、AIアシスタントをNextcloudインスタンスに接続します。
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で動かす(インストール不要):
このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。
README
以下は原文 README の抜粋です。原文を見る。
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.
インストール
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"
}
}
}
}