Nextcloud MCP Server
Подключает агента к Nextcloud: заметки, календарь, контакты, файлы, почта и доски Deck через 110 с лишним инструментов MCP
- 405 ★ репозитория
- Последний коммит
- AGPL-3.0
Широкий доступ
Почему такой уровень
- Агент читает, меняет и удаляет файлы, заметки и события, отправляет письма из подключенной почты
- Пароль приложения открывает все данные учетной записи Nextcloud, поэтому его лучше выпускать отдельно для сервера и отзывать после работы
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/nextcloud-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент читает, меняет и удаляет файлы, заметки и события, отправляет письма из подключенной почты
- Пароль приложения открывает все данные учетной записи Nextcloud, поэтому его лучше выпускать отдельно для сервера и отзывать после работы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Nextcloud MCP Server связывает Claude Code, Claude Desktop и другие MCP-клиенты с вашим экземпляром Nextcloud. Агент выполняет просьбы на обычном языке: заводит заметки, правит события календаря, ищет контакты, читает и пишет файлы по WebDAV, переносит карточки между колонками досок Deck. Сервер запускается отдельно от Nextcloud: локально через uvx, в Docker, на виртуальной машине или в Kubernetes. Инструментов больше 110, и они покрывают заметки, календарь с задачами и повторяющимися событиями, контакты по CardDAV, файлы, Deck, кулинарную книгу Cookbook, таблицы Tables, общий доступ, ленту News, Talk, коллективы и список покупок. Для почты есть чтение ящиков и писем, отправка, черновики, флаги, теги и перенос. Экспериментальный семантический поиск ищет по смыслу в заметках, файлах, новостях, карточках Deck и письмах, так что запрос про машину находит и записи про транспорт. Он выключен по умолчанию и требует векторную базу Qdrant и сервис эмбеддингов вроде Ollama. Отдельно сервер достает текст из PDF, DOCX и изображений с помощью OCR.
Для кого. Для тех, кто хранит рабочие данные в собственном Nextcloud и хочет управлять заметками, календарем, файлами и почтой из Claude Code или другой среды с MCP.
Подходит, если
- Нужно попросить агента завести заметку или событие в календаре Nextcloud, не открывая веб-интерфейс
- Задачи ведутся на досках Deck, и агент должен создавать карточки, расставлять метки и назначать исполнителей
- В Nextcloud лежит рабочий архив PDF и документов, и нужно искать в нем по смыслу или вытаскивать текст через OCR
- Вы переносите рецепты по ссылке в Cookbook или наполняете список покупок целыми рецептами
- Сервер нужен нескольким пользователям: режим Login Flow v2 выдает каждому собственный пароль приложения
Не подходит, если
- Нужен ИИ внутри самого Nextcloud: сервер рассчитан на внешних клиентов, а для встроенного Assistant автор предлагает связку с приложением Astrolabe
- Нет Nextcloud: сервер не работает с другими облаками и файловыми хранилищами
- Не хочется ставить Qdrant и сервис эмбеддингов: семантический поиск без них не заработает, остается поиск по ключевым словам
- Нужно подключиться к Nextcloud напрямую через OAuth: этот режим автор убрал, для нескольких пользователей остается Login Flow v2
Пример запроса к агенту
Найди в Nextcloud мои заметки про отпуск, создай в календаре событие на пятницу и положи карточку «Купить билеты» в колонку «В работе» на доске поездки.MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
NEXTCLOUD_HOSTобязательная- Адрес вашего экземпляра Nextcloud
NEXTCLOUD_USERNAMEобязательная- Имя пользователя Nextcloud
NEXTCLOUD_PASSWORDобязательная, секрет- Пароль приложения, созданный в настройках безопасности Nextcloud
ENABLE_SEMANTIC_SEARCH- Включает экспериментальный семантический поиск, по умолчанию false
EXCLUDED_TAGS- Системный тег Nextcloud, файлы с которым скрыты от файловых инструментов
Ограничения
Сервер подключается к Nextcloud по паролю приложения, его создают в настройках безопасности на странице устройств и сессий. Пароль учетной записи для этого брать не стоит. Режим с передачей OAuth напрямую в Nextcloud исключен из проекта, потому что для него требовались исправления в user_oidc, которые так и не приняли.
Семантический поиск помечен как экспериментальный, он выключен переменной ENABLE_SEMANTIC_SEARCH=false и нужен только с отдельной векторной базой и сервисом эмбеддингов. Для пересортировки результатов описаны Infinity, vLLM и Cohere.
Лицензия AGPL-3.0: при изменении кода и предоставлении сервера другим по сети придется открыть изменения. Сервер ходит только к вашему экземпляру Nextcloud, поэтому доступность из России определяется тем, где он установлен.
Как отключить. Уберите блок nextcloud из конфигурации MCP-клиента и перезапустите клиента. Для Docker остановите контейнер. Чтобы закрыть доступ полностью, удалите пароль приложения в Nextcloud на странице устройств и сессий.
Частые вопросы
Как подключить Nextcloud к Claude Code?
Запустите сервер командой uvx nextcloud-mcp-server run --transport stdio с переменными NEXTCLOUD_HOST, NEXTCLOUD_USERNAME и NEXTCLOUD_PASSWORD. Тот же блок с командой uvx и аргументами можно вписать в конфигурацию MCP клиента, например claude_desktop_config.json.
Какой пароль указывать для Nextcloud?
Пароль приложения. Его выпускают в Nextcloud в настройках безопасности на странице устройств и сессий, он отзывается отдельно и не раскрывает основной пароль.
Как запустить сервер в Docker и подключить к нему клиент?
Образ ghcr.io/cbcoutinho/nextcloud-mcp-server запускается с теми же переменными окружения и портом 8000. Клиент подключают к адресу http://127.0.0.1:8000/mcp. Для полного набора функций, включая семантический поиск, автор советует Docker.
Какие приложения Nextcloud поддерживает сервер?
Заметки, календарь, контакты, файлы по WebDAV, Deck, Cookbook, Tables, общий доступ, News, почту, коллективы, Talk и список покупок. У каждого приложения свой набор инструментов, например у календаря больше двадцати.
Как скрыть часть файлов от агента?
Пометьте нужные файлы или папки системным тегом Nextcloud и укажите его имя в переменной EXCLUDED_TAGS. Файловые инструменты MCP перестанут их показывать.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для работы агента с локальным компьютером: терминал и долгие процессы, поиск и правка файлов, Excel, PDF и DOCX
Официальный MCP-сервер Kibela ищет, читает и правит заметки, папки и комментарии вашей вики прямо из чата с ассистентом
MCP-сервер для доступа агента к почте, календарю, файлам OneDrive и потокам Power Automate через Microsoft Graph
DoodleNote MCP — заметки встреч для агентов
DoodleNote MCP
MCP-сервер только для чтения: Claude Code, Claude Desktop и Codex ищут по локальным встречам, заметкам и транскриптам DoodleNote
MCP-сервер почты по IMAP и SMTP: агент ищет, читает, сортирует и отправляет письма из нескольких ящиков
Google Docs MCP — Docs, Sheets, Drive, Gmail и Calendar
Google Docs MCP
MCP-сервер дает агенту Google Docs, Sheets, Drive, Gmail, Calendar и Apps Script: чтение, правка, письма и события; вход через OAuth
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Nextcloud MCP Server (эта карточка) | нет | API-ключ | 405 | |
| outlook-mcp | нет | OAuth | 450 | открывает почту, календарь и файлы OneDrive из облака Microsoft |
| MCP iCal Server | нет | не нужна | 333 | работает только с календарем macOS |
Коротко о README
README разделяет три режима входа: один пользователь с паролем приложения, несколько пользователей с передачей учетных данных в заголовке и Login Flow v2, где клиенты входят в MCP-сервер через OAuth, а он сам получает пароль приложения. Отдельный раздел объясняет, как связать сервер с Nextcloud Assistant через приложение Astrolabe. Автор также развивает платный хостинг Astrolabe Cloud, он еще в разработке.