nextcloud-agent¶
Nextcloud MCP server + A2A agent for the Arbora ecosystem — typed, typed per-operation tools over the Nextcloud Files, Sharing, Calendar, Tasks, Contacts, Talk, Deck, Notes, Office, Activity and Administration surfaces, plus an integrated Pydantic-AI graph agent.
Official documentation
This site is the canonical reference for nextcloud-agent, maintained alongside
every release.
The generated spec-delivery dashboard records the source-backed delivery state for this connector.
Overview¶
nextcloud-agent wraps the Nextcloud WebDAV, CalDAV, CardDAV, and OCS REST surfaces
with typed, deterministic MCP tools, and ships a graph agent that an operator or
upstream orchestrator can call. It provides:
NextcloudAPI— arequests-based client over the Nextcloud WebDAV / CalDAV / CardDAV / OCS / app REST endpoints, composed from per-domain sub-clients (files, shares, calendar and tasks, contacts, Talk, Deck, notes, office, activity, administration).- One typed MCP tool per operation — 89
nextcloud_<operation>tools, grouped into ten domains, each domain gated by a toggle environment variable. - Skills, prompts and ontology — a skill per domain plus the asset-publishing workflow, agent-defining prompts per business role, and an ontology of the tools, tool-use contracts and data locations.
- An integrated A2A agent — a Pydantic-AI graph agent (console script
nextcloud-agent) with an optional web UI that calls the MCP server.
Explore the documentation¶
- :material-rocket-start: Installation — pip, source, uv, and the prebuilt Docker image.
- Deployment — run the MCP server and the agent, Docker Compose, Caddy + Technitium.
- Usage — the MCP tools, the
NextcloudAPIclient, and the agent CLI. - Backing Platform — deploy Nextcloud with Docker.
- Overview — the per-operation tool surface and ecosystem role.
- Concepts — the
CONCEPT:NC-*registry.
Quick start¶
Connect it to a Nextcloud instance:
export NEXTCLOUD_URL=https://nextcloud.example.com
export NEXTCLOUD_USERNAME=your-user
export NEXTCLOUD_PASSWORD=your-app-password
nextcloud-mcp --transport streamable-http --host 0.0.0.0 --port 8000
See Installation and Deployment for the full matrix (PyPI, Docker image, all transports, the agent server, reverse proxy, DNS).