DocSpace MCP Server

What is DocSpace MCP Server?

The server implements the Model Context Protocol for ONLYOFFICE DocSpace, exposing operations such as file upload, folder management, user lookup, and room administration as discrete tools that can be invoked by LLMs.

How to use DocSpace MCP Server?

Add to MCP client configuration – include an entry under mcpServers with the required environment variables (DOCSPACE_BASE_URL, DOCSPACE_API_KEY).
Install via npx – the server runs with the command npx --yes @onlyoffice/docspace-mcp.
Choose transport – default is stdio; HTTP transport can be enabled by setting DOCSPACE_TRANSPORT=http and configuring host/port.
Select toolsets – control which toolsets or individual tools are exposed using DOCSPACE_TOOLSETS, DOCSPACE_ENABLED_TOOLS, and DOCSPACE_DISABLED_TOOLS.
Enable dynamic tools (optional) – set DOCSPACE_DYNAMIC=true to wrap all tools into meta‑tools (call_tool, list_tools, etc.).

Key Features

Comprehensive toolset covering files, folders, people, and rooms.
Configurable exposure of toolsets and individual tools.
Dynamic meta‑tools for on‑demand tool discovery and invocation.
Multiple transport options (stdio for direct integration, http for networked access).
Environment‑based configuration, simplifying deployment in CI/CD pipelines.
Built with Node.js, runnable via a single npx command.

Use Cases

AI assistants that need to read, create, or modify documents stored in DocSpace.
Automation bots that organize files/folders or manage room permissions based on business rules.
Chat‑based agents that can fetch user information or list available rooms for collaboration.
Custom workflows integrating DocSpace actions into larger enterprise automation pipelines.

FAQ

Do I need to build the server from source? No; the pre‑published npm package can be run directly with npx.
Which authentication methods are supported? API key (DOCSPACE_API_KEY), personal access token (DOCSPACE_AUTH_TOKEN), or basic auth (DOCSPACE_USERNAME/DOCSPACE_PASSWORD).
Can I run the server over HTTP? Yes, set DOCSPACE_TRANSPORT=http and configure DOCSPACE_HOST and DOCSPACE_PORT.
What is the default toolset? All toolsets (files, folders, people, rooms) are enabled unless overridden by configuration.
Is the server production‑ready? It is currently in preview; expect possible breaking changes and test thoroughly before critical deployment.

ONLYOFFICE DocSpace MCP Server

Model Context Protocol (MCP) is a standardized protocol for managing context between large language models (LLMs) and external systems. This repository provides an MCP server for ONLYOFFICE DocSpace.

[!WARNING]

This DocSpace MCP server is currently in preview state. While functional, it may undergo breaking changes, have incomplete features, or contain bugs. Use with caution in production environments and expect potential updates that could affect compatibility.

{
	"mcpServers": {
		"onlyoffice-docspace": {
			"command": "docker",
			"args": ["run", "onlyoffice/docspace-mcp", "--interactive", "--rm", "--env", "DOCSPACE_BASE_URL", "--env", "DOCSPACE_API_KEY"],
			"env": {
				"DOCSPACE_BASE_URL": "https://your-instance.onlyoffice.com",
				"DOCSPACE_API_KEY": "your-api-key"
			}
		}
	}
}

Features

Tools with granular control - Access to tools organized into logical toolsets with fine-grained enable/disable capabilities and meta tools.
Multiple transport protocols - Support for stdio, SSE, and Streamable HTTP transports.
Different authentication methods - Supports OAuth, API keys, Personal Access Tokens, and Basic authentication.
Request-level configuration - Configure authentication and tool selection during session initialization using custom HTTP headers.
Various distribution formats - Available as Docker image, Docker MCP Server, MCP bundle, and Node.js application.

Documentation

The documentation is available in the docs directory.

License

The DocSpace MCP server is distributed under the Apache-2.0 license found in the LICENSE file.