ONLYOFFICE DocSpace MCP Server

Name: ONLYOFFICE DocSpace MCP Server
Author: ONLYOFFICE

ONLYOFFICEOfficial

Get started Repository Website & docs

Uses the ONLYOFFICE DocSpace API to create rooms and manage files and folders.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

Local

claude mcp add onlyoffice-docspace --env DOCSPACE_API_KEY='<DOCSPACE_API_KEY>' --env DOCSPACE_AUTH_TOKEN='<DOCSPACE_AUTH_TOKEN>' --env DOCSPACE_AUTHORIZATION='<DOCSPACE_AUTHORIZATION>' --env DOCSPACE_PASSWORD='<DOCSPACE_PASSWORD>' --env DOCSPACE_BASE_URL='<DOCSPACE_BASE_URL>' -- npx -y @onlyoffice/docspace-mcp

~/.codex/config.toml

[mcp_servers.onlyoffice-docspace]
command = "npx"
args = ["-y", "@onlyoffice/docspace-mcp"]
env = { DOCSPACE_API_KEY = "<DOCSPACE_API_KEY>", DOCSPACE_AUTH_TOKEN = "<DOCSPACE_AUTH_TOKEN>", DOCSPACE_AUTHORIZATION = "<DOCSPACE_AUTHORIZATION>", DOCSPACE_PASSWORD = "<DOCSPACE_PASSWORD>", DOCSPACE_BASE_URL = "<DOCSPACE_BASE_URL>" }

# codex mcp add onlyoffice-docspace --env DOCSPACE_API_KEY='<DOCSPACE_API_KEY>' --env DOCSPACE_AUTH_TOKEN='<DOCSPACE_AUTH_TOKEN>' --env DOCSPACE_AUTHORIZATION='<DOCSPACE_AUTHORIZATION>' --env DOCSPACE_PASSWORD='<DOCSPACE_PASSWORD>' --env DOCSPACE_BASE_URL='<DOCSPACE_BASE_URL>' -- npx -y @onlyoffice/docspace-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "onlyoffice-docspace": {
      "command": "npx",
      "args": [
        "-y",
        "@onlyoffice/docspace-mcp"
      ],
      "env": {
        "DOCSPACE_API_KEY": "<DOCSPACE_API_KEY>",
        "DOCSPACE_AUTH_TOKEN": "<DOCSPACE_AUTH_TOKEN>",
        "DOCSPACE_AUTHORIZATION": "<DOCSPACE_AUTHORIZATION>",
        "DOCSPACE_PASSWORD": "<DOCSPACE_PASSWORD>",
        "DOCSPACE_BASE_URL": "<DOCSPACE_BASE_URL>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "onlyoffice-docspace": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@onlyoffice/docspace-mcp"
      ],
      "env": {
        "DOCSPACE_API_KEY": "<DOCSPACE_API_KEY>",
        "DOCSPACE_AUTH_TOKEN": "<DOCSPACE_AUTH_TOKEN>",
        "DOCSPACE_AUTHORIZATION": "<DOCSPACE_AUTHORIZATION>",
        "DOCSPACE_PASSWORD": "<DOCSPACE_PASSWORD>",
        "DOCSPACE_BASE_URL": "<DOCSPACE_BASE_URL>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "onlyoffice-docspace": {
      "command": "npx",
      "args": [
        "-y",
        "@onlyoffice/docspace-mcp"
      ],
      "env": {
        "DOCSPACE_API_KEY": "<DOCSPACE_API_KEY>",
        "DOCSPACE_AUTH_TOKEN": "<DOCSPACE_AUTH_TOKEN>",
        "DOCSPACE_AUTHORIZATION": "<DOCSPACE_AUTHORIZATION>",
        "DOCSPACE_PASSWORD": "<DOCSPACE_PASSWORD>",
        "DOCSPACE_BASE_URL": "<DOCSPACE_BASE_URL>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "onlyoffice-docspace": {
      "command": "npx",
      "args": [
        "-y",
        "@onlyoffice/docspace-mcp"
      ],
      "env": {
        "DOCSPACE_API_KEY": "<DOCSPACE_API_KEY>",
        "DOCSPACE_AUTH_TOKEN": "<DOCSPACE_AUTH_TOKEN>",
        "DOCSPACE_AUTHORIZATION": "<DOCSPACE_AUTHORIZATION>",
        "DOCSPACE_PASSWORD": "<DOCSPACE_PASSWORD>",
        "DOCSPACE_BASE_URL": "<DOCSPACE_BASE_URL>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "onlyoffice-docspace": {
      "command": "npx",
      "args": [
        "-y",
        "@onlyoffice/docspace-mcp"
      ],
      "env": {
        "DOCSPACE_API_KEY": "<DOCSPACE_API_KEY>",
        "DOCSPACE_AUTH_TOKEN": "<DOCSPACE_AUTH_TOKEN>",
        "DOCSPACE_AUTHORIZATION": "<DOCSPACE_AUTHORIZATION>",
        "DOCSPACE_PASSWORD": "<DOCSPACE_PASSWORD>",
        "DOCSPACE_BASE_URL": "<DOCSPACE_BASE_URL>"
      }
    }
  }
}

Remote

claude mcp add --transport http onlyoffice-docspace https://mcp.onlyoffice.com/mcp --header 'X-Mcp-Api-Key: <X_MCP_API_KEY>' --header 'X-Mcp-Auth-Token: <X_MCP_AUTH_TOKEN>' --header 'X-Mcp-Password: <X_MCP_PASSWORD>'

~/.codex/config.toml

[mcp_servers.onlyoffice-docspace]
url = "https://mcp.onlyoffice.com/mcp"
http_headers = { X-Mcp-Api-Key = "<X_MCP_API_KEY>", X-Mcp-Auth-Token = "<X_MCP_AUTH_TOKEN>", X-Mcp-Password = "<X_MCP_PASSWORD>" }

# codex mcp add onlyoffice-docspace --url https://mcp.onlyoffice.com/mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "onlyoffice-docspace": {
      "url": "https://mcp.onlyoffice.com/mcp",
      "headers": {
        "X-Mcp-Api-Key": "<X_MCP_API_KEY>",
        "X-Mcp-Auth-Token": "<X_MCP_AUTH_TOKEN>",
        "X-Mcp-Password": "<X_MCP_PASSWORD>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "onlyoffice-docspace": {
      "type": "http",
      "url": "https://mcp.onlyoffice.com/mcp",
      "headers": {
        "X-Mcp-Api-Key": "<X_MCP_API_KEY>",
        "X-Mcp-Auth-Token": "<X_MCP_AUTH_TOKEN>",
        "X-Mcp-Password": "<X_MCP_PASSWORD>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "onlyoffice-docspace": {
      "httpUrl": "https://mcp.onlyoffice.com/mcp",
      "headers": {
        "X-Mcp-Api-Key": "<X_MCP_API_KEY>",
        "X-Mcp-Auth-Token": "<X_MCP_AUTH_TOKEN>",
        "X-Mcp-Password": "<X_MCP_PASSWORD>"
      }
    }
  }
}

claude_desktop_config.json · Customize › Connectors › Add custom connector

{
  "mcpServers": {
    "onlyoffice-docspace": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.onlyoffice.com/mcp",
        "--header",
        "X-Mcp-Api-Key:<X_MCP_API_KEY>",
        "--header",
        "X-Mcp-Auth-Token:<X_MCP_AUTH_TOKEN>",
        "--header",
        "X-Mcp-Password:<X_MCP_PASSWORD>"
      ]
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "onlyoffice-docspace": {
      "url": "https://mcp.onlyoffice.com/mcp",
      "headers": {
        "X-Mcp-Api-Key": "<X_MCP_API_KEY>",
        "X-Mcp-Auth-Token": "<X_MCP_AUTH_TOKEN>",
        "X-Mcp-Password": "<X_MCP_PASSWORD>"
      }
    }
  }
}

Environment variables

DOCSPACE_API_KEY
DOCSPACE_AUTH_TOKEN
DOCSPACE_AUTHORIZATION
DOCSPACE_PASSWORD
DOCSPACE_BASE_URL

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Local

Remote

Environment variables

Related