How to Use the Nextcloud MCP in Windsurf

Q: How do I connect my Nextcloud account to Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers key. Alternatively, use the Settings menu, navigate to Cascade, and add it via the MCP Servers UI. Click Refresh in the MCP panel to let Cascade discover the tools.

Q: Can Windsurf Cascade create public download links for Nextcloud files?

Yes, Cascade uses the createshare tool with share type 3 to generate public links. It can then copy the link directly into your workspace or insert it into your code.

Q: Can I manage Nextcloud user directories using Windsurf?

Yes, if your account has admin rights, Windsurf can run listusers to view the directory. This MCP Server also allows your agent to check server limits and configurations using the getcapabilities tool.

Q: What is the tool sequence for cleaning up expired shares?

The agent first runs listshares to retrieve all active shares on your account. It then evaluates which ones are expired or no longer needed and calls deleteshare to remove them.

Let Windsurf Cascade autonomously manage your Nextcloud files, shares, and user statuses without leaving your editor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Nextcloud MCP to Windsurf

Create your Vinkius account to connect Nextcloud to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Nextcloud with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Let Windsurf Cascade handle your Nextcloud files

The `list_files` tool gives your agent instant access to your remote WebDAV directory tree to inspect files and folder hierarchies. Cascade reads these paths directly, planning multi-step operations without asking for permission at every turn. When you need modifications, the agent runs `create_folder` and `delete_file` to organize your remote storage on the fly. Just tell Cascade what to clean up, and it executes the sequence.

Automate file sharing inside your IDE

The `create_share` tool lets your agent generate public links, email invitations, or direct user-to-user shares without you opening a browser. Cascade chains this with `list_shares` to audit your current sharing configurations and identify exposed assets. If a share needs modification, Cascade invokes `update_share` or `delete_share` to adjust permissions or revoke access instantly. This setup keeps your collaboration channels secure while letting your agent handle the administrative overhead.

Keep your Nextcloud status updated through this MCP Server

The `set_user_status` tool changes your online availability status directly from the Windsurf interface. Your agent coordinates this with your current coding activity, changing your status message automatically when you switch tasks. By calling `set_user_status_message` alongside `get_user_status`, the agent updates your team on what you are working on. It also uses `get_user` to pull profile details and coordinate with other team members on the same server.

Setup guide

Set up Nextcloud MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Nextcloud MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Nextcloud payment history." If connected, Cascade will call the Nextcloud tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "nextcloud-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Nextcloud. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Nextcloud now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Nextcloud MCP in Windsurf

Open your ~/.codeium/windsurf/mcp_config.json file and add the server configuration under the mcpServers key. Alternatively, use the Settings menu, navigate to Cascade, and add it via the MCP Servers UI. Click Refresh in the MCP panel to let Cascade discover the tools.

Yes, Cascade uses the `create_share` tool with share type 3 to generate public links. It can then copy the link directly into your workspace or insert it into your code.

Yes, if your account has admin rights, Windsurf can run `list_users` to view the directory. This MCP Server also allows your agent to check server limits and configurations using the `get_capabilities` tool.

The agent first runs `list_shares` to retrieve all active shares on your account. It then evaluates which ones are expired or no longer needed and calls `delete_share` to remove them.

Yes. This server only handles your files, shares, and user statuses through secure WebDAV and OCS API calls. Your credentials remain in your local config, and the Vinkius sandbox ensures that data never leaks to unauthorized third parties.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript