Connect your AI to Nextcloud

What your AI can do with Nextcloud

Once connected, these tools appear automatically in your AI assistant:

• list_filesread-only

  List the folders and files directly inside a folder (one level deep), with type, size and last-modified time. Use the returned path to descend into a subfolder or to act on an item.

• read_text_fileread-only

  Read the contents of a text file (notes, markdown, code, CSV…). Binary files are not supported; very large files are truncated.

• create_folderwrite · needs approval

  Create a folder at the given path (the parent folder must already exist). Writes to Nextcloud, so it goes through the confirmation guardrail when enabled.

• upload_text_filewrite · needs approval

  Create or overwrite a text file with the given content (the parent folder must already exist). Writes to Nextcloud, so it goes through the confirmation guardrail when enabled.

• delete_itemwrite · needs approval

  Delete a file or folder (a folder is removed with everything inside it). Writes to Nextcloud, so it goes through the confirmation guardrail when enabled.

• move_itemwrite · needs approval

  Move or rename a file or folder to a new path (the destination's parent folder must already exist). Writes to Nextcloud, so it goes through the confirmation guardrail when enabled.

• list_sharesread-only

  List existing shares (public links and shares with users or groups), optionally only those on a given file or folder path.

• create_sharewrite · needs approval

  Share a file or folder. Choose 'public_link' for a shareable URL (optionally password protected and read-only), or 'user'/'group' to share with someone on the instance. Writes to Nextcloud, so it goes through the confirmation guardrail when enabled.

• delete_sharewrite · needs approval

  Remove an existing share by its id (from list_shares). Writes to Nextcloud, so it goes through the confirmation guardrail when enabled.

• get_user_inforead-only

  Get the connected user's account details: display name, email, groups and storage quota (used, total, free).

• update_sharewrite · needs approval

  Change an existing share: make it read-only or writable again, set or clear its expiry date, or put a password on a public link. Writes to Nextcloud, so it goes through the confirmation guardrail when enabled.

• search_filesread-only

  Search the account's files by name through Nextcloud's own search, when you do not know which folder holds what you are after.

• list_activityread-only

  Recent activity on the account's files: what was created, changed, shared or deleted, by whom and when. Requires the Activity app (shipped and enabled by default).

• list_users_and_groupsread-only

  List the instance's user accounts or its groups. Nextcloud restricts this to administrators, so it answers 403 for an ordinary account — that is a permission answer, not a broken connection.

• copy_itemwrite · needs approval

  Copy a file or folder to another path, leaving the original in place. Writes to Nextcloud, so it goes through the confirmation guardrail when enabled.

• list_trashread-only

  List what is in the account's trash, with the path each item came from and when it was deleted — the first step before restoring something.

• list_file_versionsread-only

  List the stored versions of a file — when each was saved and how big it was — using the file id that list_files reports.

Example prompts

Just ask your AI in plain language — it picks the right Nextcloud tool:

• “Find every document mentioning last year's audit and tell me which folders they live in.”
• “Which public links are still active, and which of them have no expiry date set?”
• “Make the share on the Contracts folder read-only and give it a password.”
• “What changed in my files this week, and who changed it?”
• “I deleted something from Documents yesterday — what is in the trash from that folder?”

How it works

1. Create your Proxoria account and add your MCP endpoint to Claude or ChatGPT.
2. Connect Nextcloud with your API key — each user connects their own account, credentials encrypted at rest.
3. Your AI instantly gets the Nextcloud tools. Write actions wait for your approval in the dashboard before anything changes.

Frequently asked questions

Does Nextcloud have an official MCP server?

You don't need one. Proxoria exposes Nextcloud to your AI through the Model Context Protocol, so you can use it from Claude, ChatGPT, Mistral or any MCP-compatible client — no official Nextcloud MCP server required.

What can my AI do with Nextcloud through Proxoria?

It gets 17 tools: list_files, read_text_file, create_folder, upload_text_file, delete_item, move_item, list_shares, create_share, delete_share, get_user_info, update_share, search_files, list_activity, list_users_and_groups, copy_item, list_trash, list_file_versions. For example, list the folders and files directly inside a folder (one level deep), with type, size and last-modified time. use the returned path to descend into a subfolder or to act on an item.

Is the Nextcloud connector read-only?

No — it can also make changes. Write actions go through Proxoria's confirmation guardrail by default: your AI proposes them, and you approve each one from your dashboard before anything is written to Nextcloud.

How do I connect Nextcloud to my AI?

Create a Proxoria account, connect Nextcloud with your API key, and add your Proxoria MCP endpoint to Claude or ChatGPT. Your AI instantly gains the Nextcloud tools.