← Back to directory
O

ONLYOFFICE DocSpace MCP Server

Official
Connect AI agents directly to ONLYOFFICE DocSpace to manage rooms, files, and permissions in natural language.
GitHub source repository ↗
★ 29 Stars Category · Collaboration Popular
55FMRS · C

An official ONLYOFFICE-maintained DocSpace MCP server that plugs AI clients directly into DocSpace for room, file, permission, and people management. It offers stdio/SSE/Streamable HTTP transports, multiple authentication methods, and a hosted remote instance under the MIT license. Best suited to DocSpace users who want natural-language automation of document collaboration, though credentials must be protected and destructive batch operations handled with care.

Reliability
8/20
Security and permissions
9/20
Maintenance
11/20
Documentation
14/20
Setup experience
13/20
Read the FMRS scoring method →

The ONLYOFFICE DocSpace MCP Server is ONLYOFFICE's official Model Context Protocol server that connects AI tools directly to ONLYOFFICE DocSpace. It gives AI agents, assistants, and chatbots the ability to manage rooms, collaborate on files, handle permissions, and automate document workflows through natural language interactions. The server supports stdio, SSE, and Streamable HTTP transports, accepts API keys, Personal Access Tokens, Basic authentication, and OAuth 2.0 with dynamic client registration, and allows request-level configuration of authentication and tool selection via custom HTTP headers at session initialization. Tools are organized into logical toolsets with fine-grained enable/disable capabilities and meta tools, and the server is distributed as a Docker image, Docker MCP Server, MCP bundle, and Node.js application. ONLYOFFICE also hosts remote instances (https://mcp.onlyoffice.com/mcp and https://mcp.onlyoffice.com/sse) for instant connection without deployment.

Setup

  1. Locate your client's JSON configuration file.
  2. Add an onlyoffice-docspace entry under mcpServers: command is docker, args are run --interactive --rm --env DOCSPACE_BASE_URL --env DOCSPACE_API_KEY onlyoffice/docspace-mcp (Docker must be installed).
  3. Set environment values: DOCSPACE_BASE_URL to your DocSpace instance URL, and DOCSPACE_API_KEY to your personal API key generated in DocSpace settings -> Developer Tools -> API keys.
  4. Restart the client; the server usually starts automatically, and you can issue natural language commands such as "Create a new project room and invite Anna with editor rights."

Alternatively, connect to the ONLYOFFICE-hosted remote server: use https://mcp.onlyoffice.com/mcp for clients supporting Streamable HTTP, or https://mcp.onlyoffice.com/sse for clients that only support legacy SSE.

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

Fit and risk

Best for

  • Users of MCP clients such as Claude Desktop, Cursor, and Windsurf who want to operate ONLYOFFICE DocSpace in natural language.
  • Teams that need to automate room, document, and permission management inside AI workflows.
  • Users who prefer the ONLYOFFICE-hosted remote MCP server with no deployment required.
  • Integrations that need flexible request-level authentication and tool selection.

Not for

  • Users who do not use ONLYOFFICE DocSpace or do not plan to connect their portal.
  • Environments that must run fully offline without any external service.
  • Users who only want to manage non-DocSpace document systems (other cloud drives or local file systems).

Required permissions

  • The DocSpace instance URL (DOCSPACE_BASE_URL) is required.
  • DocSpace credentials are required: API key, Personal Access Token, Basic authentication, or OAuth 2.0.
  • Credentials are supplied via environment variables or client configuration.
  • Authentication and tool selection can be configured per request using custom HTTP headers at session initialization.

Risks and side effects

  • A leaked API key or token lets its holder act as you on DocSpace content.
  • An AI agent may mistakenly delete or alter files or permissions, especially during batch operations (copy, move, delete, archive rooms).
  • The remote MCP server is hosted by ONLYOFFICE; review its Legal Terms and Privacy Policy before use.
  • Credentials are stored in plain environment variables inside client config files and may be readable locally.

Troubleshooting

  1. Verify DOCSPACE_BASE_URL points to the correct DocSpace instance (e.g. https://portal.onlyoffice.com).
  2. Verify DOCSPACE_API_KEY was generated in DocSpace settings -> Developer Tools -> API keys and is still valid.
  3. For the local server, confirm Docker is installed and running and that the onlyoffice/docspace-mcp image pulls correctly.
  4. When using the remote server, check whether your client supports Streamable HTTP; if it only supports SSE, use the /sse endpoint.
  5. Restart the client after changing configuration and confirm the server starts automatically.
  6. If tools are unavailable, check whether they were disabled by toolset or meta tool settings.

Use cases

Room management: create, update, and archive rooms; configure room types; manage membership and access levels.
Folder and file operations: create folders, upload documents, copy or move items in batches, rename or delete content, and check file or folder details.
Collaboration and permissions: invite or remove users, adjust security settings, and review current access rights for rooms and shared spaces.
Content access: retrieve "My documents" or "Rooms" folders, get folder contents, download files as text, and monitor ongoing file operations.
People directory: list all people in the portal to streamline invitations and access management.

Supported clients

Claude DesktopFull support
CursorFull support
WindsurfFull support