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).

Example prompts

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

• “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 — from Nextcloud, in plain language.”
• “Read the contents of a text file (notes, markdown, code, CSV…). Binary files are not supported; very large files are truncated — from Nextcloud, in plain language.”
• “List existing shares (public links and shares with users or groups), optionally only those on a given file or folder path — from Nextcloud, in plain language.”
• “Get the connected user's account details: display name, email, groups and storage quota (used, total, free) — from Nextcloud, in plain language.”

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 10 tools: list_files, read_text_file, create_folder, upload_text_file, delete_item, move_item, list_shares, create_share, delete_share, get_user_info. 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.