How to Use the Nextcloud MCP in OpenAI Agents SDK

Q: How do I connect the Nextcloud MCP server to the OpenAI Agents SDK?

Install openai-agents via pip. Initialize MCPServerStreamableHttp with your Vinkius URL, then pass it to the mcpservers list in your Agent constructor. Set cacheToolsList=True to speed up tool discovery.

Q: Can the OpenAI Agents SDK manage Nextcloud app passwords?

Yes. Your agent calls getapppassword to generate new credentials, assuming it authenticates with the real user password first. It revokes them later using deleteapppassword.

Q: Does the Nextcloud MCP integration support OpenAI agent handoffs?

It does. You set up a read-only agent to run listfiles and getcapabilities, then hand off to a privileged admin agent to execute deletefile or deleteshare.

Q: Why does my OpenAI Agents SDK bot fail to run listusers in Nextcloud?

The listusers tool requires admin privileges. If your Vinkius endpoint token is tied to a standard user account, the API rejects the request. Use an admin account token.

Connect your Nextcloud MCP Server to the OpenAI Agents SDK. Build production agents that manage files and users with full execution tracing.

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 OpenAI Agents SDK

Create your Vinkius account to connect Nextcloud to OpenAI Agents SDK 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 OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Nextcloud MCP Server file operations

The Nextcloud MCP Server exposes `list_files`, `create_folder`, and `delete_file` directly to your OpenAI agents. You can point a dedicated file-management agent at a user's root directory and let it organize WebDAV paths autonomously. Built-in guardrails in the OpenAI Agents SDK catch destructive actions before they execute. If an agent tries to loop `delete_file` across an entire directory tree, you intercept that request or hand it off to a human-in-the-loop validation step.

Automate link and group sharing

Your agents handle external distribution using `create_share`, `update_share`, and `list_shares`. Need to distribute reports? The agent generates a public link (Share Type 3) or emails it directly (Share Type 4) without you writing custom API wrappers. You track what the agent actually did by checking the OpenAI dashboard tracing. If an agent creates a federated share (Type 6) by mistake, you just call `delete_share` to revoke access immediately.

Track user status and activity

Admin-level agents pull system-wide context using `list_users` and `list_activities`. This gives your AI client a complete picture of who modified what file and when. Managing presence happens via `set_user_status` and `set_user_status_message`. If an on-call agent detects an outage, it automatically updates the status message of the relevant engineering group in Nextcloud.

Setup guide

Set up Nextcloud MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Nextcloud tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Nextcloud tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Nextcloud tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Nextcloud Agent",
            instructions="You have access to Nextcloud tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 OpenAI Agents SDK

Install `openai-agents` via pip. Initialize `MCPServerStreamableHttp` with your Vinkius URL, then pass it to the `mcp_servers` list in your Agent constructor. Set `cacheToolsList=True` to speed up tool discovery.

Yes. Your agent calls `get_app_password` to generate new credentials, assuming it authenticates with the real user password first. It revokes them later using `delete_app_password`.

It does. You set up a read-only agent to run `list_files` and `get_capabilities`, then hand off to a privileged admin agent to execute `delete_file` or `delete_share`.

The `list_users` tool requires admin privileges. If your Vinkius endpoint token is tied to a standard user account, the API rejects the request. Use an admin account token.

This server processes WebDAV file paths, share links, and user activity logs. Vinkius runs the Nextcloud MCP Server in an ephemeral V8 Isolate Sandbox. The container dies the moment the OpenAI agent finishes its execution, leaving zero residual data behind.

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