ocis-mcp-server

A standalone Model Context Protocol (MCP) server that exposes ownCloud Infinite Scale (oCIS) as a set of MCP tools. It enables AI assistants such as Claude to manage users, groups, spaces, files, shares, and more through natural language.

Guides

New to this? Check out the Getting Started Guide -- a step-by-step walkthrough for connecting the MCP server with Claude Desktop or Ollama on Mac, Windows, and Linux. Includes a setup script (install.sh) that detects your system and helps you configure everything.

Why Standalone?

This server is intentionally separate from the oCIS codebase:

• External client -- communicates with oCIS over its public APIs (LibreGraph, WebDAV, OCS) exactly the way any other integration would.
• No oCIS Go imports -- zero dependency on oCIS internals; works with any oCIS version that exposes the standard API surface.
• Independent release cadence -- can ship fixes and new tools without waiting for an oCIS release cycle.
• Minimal dependency tree -- only the MCP Go SDK and the standard library.

Architecture

flowchart LR
    subgraph "AI Host"
        A[Claude Desktop / Claude Code]
    end

    subgraph "MCP Server"
        B[ocis-mcp-server]
        B1[Tools - 80 tools]
        B2[Resources - 5 endpoints]
        B3[Prompts - 4 templates]
        B --> B1
        B --> B2
        B --> B3
    end

    subgraph "oCIS Instance"
        C[LibreGraph API]
        D[WebDAV]
        E[OCS API]
    end

    A -- "MCP (stdio / HTTP)" --> B
    B1 -- "HTTPS" --> C
    B1 -- "HTTPS" --> D
    B1 -- "HTTPS" --> E

Quickstart

Prerequisites

• A running oCIS instance
• An app token or OIDC access token for authentication
• Go 1.25+ (only for building from source)

Install from Release

Download a pre-built binary from the Releases page, extract the archive, and make it executable:

# Example for macOS (Apple Silicon)
tar xzf ocis-mcp-server_*_darwin_arm64.tar.gz
chmod +x ocis-mcp-server

macOS users: macOS quarantines downloaded binaries. You must remove the quarantine flag before the binary can run:

xattr -d com.apple.quarantine ocis-mcp-server

Without this step, macOS will show "Apple could not verify this software" and Claude Desktop will fail with "Permission denied".

Build from Source

go build -o ocis-mcp-server ./cmd/ocis-mcp-server

Or use Make:

make build

Claude Desktop Configuration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "ocis": {
      "command": "/path/to/ocis-mcp-server",
      "env": {
        "OCIS_MCP_OCIS_URL": "https://your-ocis-instance.example.com",
        "OCIS_MCP_APP_TOKEN_USER": "admin",
        "OCIS_MCP_APP_TOKEN_VALUE": "your-app-token-here"
      }
    }
  }
}

Claude Code Configuration

Add to .mcp.json in your project root or ~/.claude/mcp.json globally:

{
  "mcpServers": {
    "ocis": {
      "command": "/path/to/ocis-mcp-server",
      "env": {
        "OCIS_MCP_OCIS_URL": "https://your-ocis-instance.example.com",
        "OCIS_MCP_APP_TOKEN_USER": "admin",
        "OCIS_MCP_APP_TOKEN_VALUE": "your-app-token-here"
      }
    }
  }
}

Authentication

App Tokens (Recommended)

App tokens provide scoped, revocable credentials ideal for MCP server use:

1. Log in to oCIS web UI as the target user.
2. Navigate to Settings > Security > App tokens.
3. Create a new token with an appropriate label (e.g., "MCP Server").
4. Set the environment variables:

export OCIS_MCP_OCIS_URL="https://ocis.example.com"
export OCIS_MCP_APP_TOKEN_USER="admin"
export OCIS_MCP_APP_TOKEN_VALUE="<token-value>"

OIDC (Alternative)

For environments us

... View full README on GitHub