archive_room
Archive a room.
LABSCO SUMMARY
Room membership and file work in the same place, which is where DocSpace admin time actually goes.
Creating a room of the right type, inviting the right people at the right access level, and moving the documents in is one continuous task here rather than three trips through the web interface — and get_room_types and get_room_access_levels mean the model asks the portal what is valid instead of guessing. The meta-tool mode is worth knowing about if tool-list size matters to you: the same operations become five entries that a model discovers through, at the cost of an extra call before each action.
What it is
ONLYOFFICE's own server for DocSpace, hosted or local. Tools are grouped into four toolsets — files, folders, rooms and people — and can be exposed either directly or behind meta tools that let a model discover and call them without loading every schema.
What you get
- Rooms created by type, updated, archived and inspected, with get_room_types and get_room_access_levels reporting what the portal actually offers
- set_room_security invites or removes users with an optional notification message and culture, and get_room_security_info lists who currently has which access level
- Folders created, renamed, deleted and read, with get_my_folder and get_rooms_folder as the entry points into the tree
- Files uploaded by content, updated, deleted and inspected; download_file_as_text returns a document's text, which is what makes its contents usable in a conversation
- copy_batch_items and move_batch_items move sets of files and folders in one call rather than one at a time
- get_all_people lists the portal's directory, so invitations do not depend on remembering email addresses
- Meta tools as an alternative shape: list_toolsets, list_tools, get_tool_input_schema, get_tool_output_schema and call_tool, so the whole surface is reachable through five entries instead of twenty-three
- Toolsets enabled or disabled individually through DOCSPACE_TOOLSETS, and authentication and tool selection settable per session through HTTP headers
Requirements
An ONLYOFFICE DocSpace portal and credentials for it. The hosted server is the fastest route — https://mcp.onlyoffice.com/mcp over Streamable HTTP, or /sse for clients that only speak the legacy transport. Running it locally means DOCSPACE_BASE_URL plus one authentication method: DOCSPACE_API_KEY, DOCSPACE_AUTH_TOKEN, or a DOCSPACE_USERNAME and DOCSPACE_PASSWORD pair — they are mutually exclusive. OAuth 2.0 with dynamic client registration is supported for remote setups. It ships as a Docker image, an npm package (@onlyoffice/docspace-mcp), an MCP bundle and a Docker MCP server.
Setup effort
Add the hosted endpoint, then sign in — paste it into your client, then approve the OAuth sign-in
USE CASES
01
Setting up a room for a new project
Check which room types the portal offers, create the room, then invite the people who need it at the access level they should have.
02
Answering a question from a document in DocSpace
Find it in its folder and download the text, so the answer comes from the document rather than from memory.
03
Reorganising a room that has grown messy
Read what is in the folders, create the structure you want, and move whole sets of files and folders in one call.
04
Reviewing who can reach a room
List the current members with their access levels, and remove or re-invite the ones that are wrong.
05
Getting a document into the portal from a conversation
Upload it into the right parent folder and confirm it landed with the title you meant.
06
Closing out a finished project
Archive the room rather than deleting it, after copying anything worth keeping somewhere else.
23 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
copy_batch_items
Copy to a folder.
create_folder
Create a folder.
create_room
Create a room.
delete_file
Delete a file.
delete_folder
Delete a folder.
download_file_as_text
Download a file as text.
get_all_people
Get all people.
get_file_info
Get file information.
get_folder_content
Get content of a folder.
get_folder_info
Get folder information.
get_my_folder
Get the 'My Documents' folder.
get_room_access_levels
Get a list of available room invitation access levels.
get_room_info
Get room information.
get_room_security_info
Get a list of users with their access levels to a room.
get_room_types
Get a list of available room types.
get_rooms_folder
Get the 'Rooms' folder.
move_batch_items
Move to a folder.
rename_folder
Rename a folder.
set_room_security
Invite or remove users from a room.
update_file
Update a file.
update_room
Update a room.
upload_file
Upload a file.
BEFORE YOU INSTALL
What to know first
Tools you get
23 tools when we connected; the project documents 28. The 28 includes five meta tools (list_tools, call_tool and others) that, when enabled, wrap the 23 regular tools, so a client sees one set or the other. Toolsets and individual tools can also be disabled.
Requires
- An ONLYOFFICE DocSpace portal account
- Hosted endpoint (https://mcp.onlyoffice.com/mcp): nothing to install — sign in with OAuth from your client
- Local run (the Any MCP client cards): Node.js 18 or later for npx, plus DOCSPACE_BASE_URL and one credential — DOCSPACE_API_KEY, DOCSPACE_AUTH_TOKEN, or DOCSPACE_USERNAME and DOCSPACE_PASSWORD
INSTALLATION
Connect your client
Server setup
Claude.ai
ENDPOINT URL
https://mcp.onlyoffice.com/mcpAdd this hosted endpoint to your MCP client, then sign in.
MCP Clients
Le Chat
URL: https://mcp.onlyoffice.com/mcp
How: Intelligence -> Connectors -> Add Connector -> Custom MCP Connector -> enter a name and server -> select "OAuth" in Authentication Methods -> Connect
Cursor
CURSOR · JSON
{
"mcpServers": {
"onlyoffice-docspace": {
"type": "http",
"url": "https://mcp.onlyoffice.com/mcp"
}
}
}Click Connect and complete the OAuth sign-in to your DocSpace portal when the client asks — the hosted endpoint needs no key in this configuration.
VS Code
VS CODE · JSON
{
"servers": {
"onlyoffice-docspace": {
"type": "http",
"url": "https://mcp.onlyoffice.com/mcp"
}
}
}Click Connect and complete the OAuth sign-in to your DocSpace portal when the client asks — the hosted endpoint needs no key in this configuration.
Windsurf
WINDSURF · JSON
{
"mcpServers": {
"onlyoffice-docspace": {
"serverUrl": "https://mcp.onlyoffice.com/mcp"
}
}
}Click Connect and complete the OAuth sign-in to your DocSpace portal when the client asks — the hosted endpoint needs no key in this configuration.
Any MCP client — npx
ANY MCP CLIENT — NPX · JSON
{
"mcpServers": {
"onlyoffice-docspace": {
"command": "npx",
"args": [
"--yes",
"@onlyoffice/docspace-mcp"
],
"env": {
"DOCSPACE_BASE_URL": "https://<YOUR_INSTANCE>.onlyoffice.com",
"DOCSPACE_API_KEY": "<YOUR_DOCSPACE_API_KEY>"
}
}
}
}Local run: https://<YOUR_INSTANCE>.onlyoffice.com is your DocSpace portal address, and <YOUR_DOCSPACE_API_KEY> an API key from that portal. DOCSPACE_API_KEY can instead be DOCSPACE_AUTH_TOKEN, or a DOCSPACE_USERNAME and DOCSPACE_PASSWORD pair — set only one of these. Needs Node.js 18 or later.
Any MCP client — Docker
ANY MCP CLIENT — DOCKER · 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_DOCSPACE_API_KEY>"
}
}
}
}Local run: https://<YOUR_INSTANCE>.onlyoffice.com is your DocSpace portal address, and <YOUR_DOCSPACE_API_KEY> an API key from that portal. DOCSPACE_API_KEY can instead be DOCSPACE_AUTH_TOKEN, or a DOCSPACE_USERNAME and DOCSPACE_PASSWORD pair — set only one of these. Needs Docker.
