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

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

Build

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 using OpenID Connect:

export OCIS_MCP_OCIS_URL="https://ocis.example.com"
export OCIS_MCP_AUTH_MODE="oidc"
export OCIS_MCP_OIDC_ACCESS_TOKEN="<access-token>"

Optionally, if you need token refresh:

export OCIS_MCP_OIDC_ISSUER="https://idp.example.com"
export OCIS_MCP_OIDC_CLIENT_ID="ocis-mcp"
export OCIS_MCP_OIDC_CLIENT_SECRET="<client-secret>"

Environment Variables

... View full README on GitHub