How to Use the Nextcloud MCP in Cursor

Q: How do I install the Nextcloud MCP Server in Cursor?

Add the server to your .cursor/mcp.json file in your project root or globally in your user settings. Once saved, Cursor detects the MCP tools and makes them available in Agent mode.

Q: Can Cursor automate file sharing in Nextcloud?

Yes, Cursor uses createshare to build links or invite users to folders. You can modify these shares programmatically using updateshare directly from the chat interface.

Q: Does Cursor support WebDAV file operations on Nextcloud?

Yes, Cursor connects via WebDAV using listfiles, createfolder, and deletefile. This allows the AI agent to read and modify your remote storage structure while you write code.

Q: Can I check my instance capabilities?

Yes, the agent runs getcapabilities to retrieve server details, supported APIs, and version information. This helps the agent understand what features your specific instance supports.

Edit code and manage your Nextcloud instance directly inside Cursor.

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 Cursor

Create your Vinkius account to connect Nextcloud to Cursor 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 Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Read and write Nextcloud files from Cursor

Directory structures are read using the `list_files` tool to give Cursor direct WebDAV access. This lets the editor pull configuration files or code snippets directly into your workspace. When your agent generates new assets, it uses `create_folder` and writes files directly to your storage. You avoid manual drag-and-drop operations entirely.

Generate app passwords inside your editor

Generating dedicated API tokens happens via the `get_app_password` tool without exposing your master password. Cursor uses this to establish secure, isolated connections to your instance. If a credential is compromised or no longer needed, `delete_app_password` revokes it instantly. This keeps your external script access clean and secure.

Manage sharing permissions using this MCP Server

With the `create_share` tool, Cursor sets up user, group, or public link shares directly from your chat. It handles various share types including federated and email shares. You can change permissions on existing shares using `update_share` or remove them completely with `delete_share`. This makes managing collaborative assets a quick, keyboard-driven process.

Setup guide

Set up Nextcloud MCP in Cursor

Prerequisites

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

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Nextcloud MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Nextcloud transactions." If the MCP tools are loaded correctly, Cursor will call the Nextcloud tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.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 Cursor

Add the server to your `.cursor/mcp.json` file in your project root or globally in your user settings. Once saved, Cursor detects the MCP tools and makes them available in Agent mode.

Yes, Cursor uses `create_share` to build links or invite users to folders. You can modify these shares programmatically using `update_share` directly from the chat interface.

Yes, Cursor connects via WebDAV using `list_files`, `create_folder`, and `delete_file`. This allows the AI agent to read and modify your remote storage structure while you write code.

Yes, the agent runs `get_capabilities` to retrieve server details, supported APIs, and version information. This helps the agent understand what features your specific instance supports.

Your credentials stay inside Cursor's local configuration or your project-scoped files. The MCP Server executes WebDAV commands locally, ensuring your file metadata never touches intermediate cloud relays.

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