ONLYOFFICE DocSpace
ONLYOFFICE DocSpace provides tenant-hosted APIs for managing rooms, documents, files, folders, users, groups, sharing, and portal settings.
Verdict
Common use cases
- Draft meeting agendas in new text files
- Organize project folders before kickoff
- Audit room permissions for compliance
- Archive completed sprint documents to trash
- Search folders for outdated file versions
Integration
- Vendor
- ONLYOFFICE DocSpace
- Category
- docs
- Auth
- API_KEY
- Tools
- 10
- Composio slug
onlyoffice_docspace
Tools
- Create Folder
Create a named subfolder inside an existing DocSpace folder.
- Create Text File
Create a plain-text file with supplied content inside a DocSpace folder.
- Delete File Or Folderdestructive
Move one file or folder to Trash, or permanently delete it when explicitly requested, then wait for the asynchronous operation to finish.
- Get Account Context
Return the connected user's identity, non-secret API-key metadata, available key permissions, portal capabilities, and quota features in one read-only preflight.
- Get File
Return metadata, version information, and effective security flags for one file by ID.
- Get Room
Return detailed metadata and effective security flags for one room by ID.
- List Folder Items
List files and subfolders in My Documents or a folder selected by numeric ID, with optional text or extension filtering.
- List Groups
List or search DocSpace groups, optionally restricted to groups associated with a user or manager role.
- List People
List visible DocSpace users, optionally filtering by text, group membership, or administrator status.
- List Rooms
List rooms visible to the connected account, optionally filtering by text and continuing from a previous page.
Setup
Setup guide
- 11. Open your ONLYOFFICE DocSpace portal and navigate to the API settings page to generate a new API key with the scopes you need—at minimum, read access to list folders and files; add write and delete scopes if you want Switchy to create or remove items. 2. Copy the generated key to your clipboard. 3. In Switchy, click Integrations in the left sidebar, find ONLYOFFICE DocSpace, and click Connect. 4. Paste your API key into the prompt and confirm. 5. Switchy will call the Get Account Context tool to verify the key and display your portal name and available permissions. 6. Open any Project, type '@ONLYOFFICE' in the chat, and ask it to list the contents of My Documents—if you see folder names and file counts, the connection is live.
What teammates see: by default, memories from ONLYOFFICE DocSpace are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Create Sprint Folder
@ONLYOFFICE Create a folder called 'Sprint 24 - Q2 Planning' inside My Documents, then confirm the folder ID so I can reference it later.
Draft Standup Template
@ONLYOFFICE Create a text file named 'Standup Notes - [today's date]' in the Sprint folder with sections for Yesterday, Today, and Blockers.
List Recent Edits
@ONLYOFFICE List all files in the 'Client Deliverables' folder, then filter for items updated in the past seven days and show their version numbers.
Audit Room Access
@ONLYOFFICE Get the room details for room ID 12345, including effective permissions and any groups with write access, then summarize who can edit.
Archive Old Drafts
@ONLYOFFICE List all files in the 'Archive Candidates' folder with '.draft' in the name, then move each one to Trash and confirm the count.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@onlyoffice list all files in the 'Q1 Planning' folder and show me which ones were updated in the last week
Found 12 items in 'Q1 Planning' (folder ID 4782). Recent updates: 'Budget Draft v3.docx' (modified 2 days ago by Sarah Chen), 'Marketing Timeline.xlsx' (modified 4 days ago by James Park), and 'Product Roadmap.pptx' (modified 6 days ago by you). The remaining 9 files haven't changed since December. All three recent files are currently unlocked and available for editing.
This example shows the MCP's folder-listing and metadata-retrieval capabilities. The List Folder Items tool returns file modification timestamps and editor identity, which the AI can filter by recency. Requires read permission on the target folder; numeric folder IDs must be known or discovered through prior navigation.
@onlyoffice create a new folder called 'Sprint 12 Retrospective' in My Documents and add a blank text file named 'action-items.txt' inside it
Created folder 'Sprint 12 Retrospective' (ID 5091) in your My Documents root. Added 'action-items.txt' (file ID 18234) as an empty plain-text document inside the new folder. Both operations completed successfully. You can now open the file in DocSpace's text editor or share the folder with your team by assigning room permissions.
Demonstrates the MCP's write capabilities: Create Folder followed by Create Text File. These are synchronous operations that return immediately with new resource IDs. The MCP can create folders and plain-text files but cannot generate rich document formats (DOCX, XLSX) or upload binary content—those require the DocSpace web UI or desktop editors.
@onlyoffice check my current DocSpace quota and list all rooms I have manager access to, then summarize which rooms are closest to their storage limits
Your DocSpace account (user ID 7721, email: alex@acme.co) has 47.2 GB used of 100 GB total quota (47% utilization). You have manager access to 6 rooms: 'Engineering' (12.1 GB), 'Sales Collateral' (8.4 GB), 'Legal Archive' (18.9 GB), 'Design Assets' (5.2 GB), 'HR Docs' (1.8 GB), and 'Executive Board' (0.9 GB). The 'Legal Archive' room accounts for 40% of your total usage and should be reviewed for archival candidates if quota pressure increases.
Combines Get Account Context (quota and permissions) with List Groups or room enumeration, then applies AI reasoning to surface actionable insights. This workflow is read-only and safe to run frequently. Note that room-level storage breakdowns may require iterating through folder structures if the portal doesn't expose per-room quotas directly—response times vary with account size.
Use-case deep-dives
When ONLYOFFICE wins for agency client file drops
A 6-person creative agency ships final assets to clients every week—PDFs, spreadsheets, branded decks. The team uses ONLYOFFICE rooms to stage deliverables before the client call, then shares a single room link when the work is approved. The Create Folder and Create Text File tools let Switchy build folder structures and drop README files during handoff prep, so the associate doesn't toggle between Slack and the DocSpace UI. The List Folder Items tool surfaces version conflicts before the client sees them. This setup works until you hit 40+ active clients; past that threshold, room sprawl makes search the bottleneck and you need a dedicated DAM. If your agency closes 8–15 projects a month and clients expect a branded portal experience, ONLYOFFICE is the right call.
ONLYOFFICE for regulated-team document snapshots
A 12-person fintech compliance team runs quarterly audits that require timestamped snapshots of policy docs, approval chains, and change logs. The team stores master copies in ONLYOFFICE rooms with granular permissions, and Switchy uses Get File and Get Room to pull metadata—version history, last editor, security flags—into the audit workbook without manual copy-paste. The Get Account Context tool confirms the API key has read-only scope before the run starts, so the auditor never risks accidental edits. This workflow breaks down if your document count exceeds 2,000 per room; List Folder Items slows to 4+ seconds and the audit script times out. If your compliance cadence is monthly or quarterly and your doc set is under 1,500 files, ONLYOFFICE gives you the metadata you need without a separate DMS.
When ONLYOFFICE scales new-hire document provisioning
A 20-person HR team onboards 3–5 hires a week, and each hire needs a personal folder pre-loaded with offer letters, benefits PDFs, and a welcome doc. The team uses ONLYOFFICE groups to segment hires by department, and Switchy calls Create Folder and Create Text File to provision the folder structure the morning before day one. The List Groups tool maps the new hire to the right department group so permissions inherit automatically. The Delete File Or Folder tool cleans up draft folders when a candidate declines. This setup works cleanly until onboarding volume hits 15+ hires a week; at that scale, the 10-tool limit feels restrictive and you want batch-create endpoints the MCP doesn't expose. If your onboarding is steady-state and under 10 hires weekly, ONLYOFFICE keeps the process out of spreadsheets.
Frequently asked
What does the ONLYOFFICE DocSpace MCP let me do in Switchy?
It lets your team create folders and text files, list documents, move items to trash, and read room metadata directly from Switchy prompts. You can browse My Documents, filter by extension, check file versions, and look up group memberships without opening the DocSpace web UI. It's useful for quick document audits and light file management during collaborative work.
Do I need admin access to connect ONLYOFFICE DocSpace?
You need an API key with sufficient permissions to read folders, create files, and delete items. ONLYOFFICE issues keys at the user or admin level; the MCP calls Get Account Context on connect to confirm which scopes your key actually has. If your key lacks delete or create permissions, those tools will fail at runtime.
Can the MCP edit existing documents or collaborate in real time?
No. It creates plain-text files and manages folder structure, but it cannot open the ONLYOFFICE editor or apply tracked changes to existing DOCX or XLSX files. For live co-editing you still need the DocSpace web interface. Use the MCP for file discovery, metadata checks, and simple text-file creation during research workflows.
How is this different from just using the DocSpace API directly?
The MCP wraps ten common operations into natural-language tools that Switchy's AI can call mid-conversation. You skip writing curl commands or managing pagination logic. The trade-off is you only get the ten exposed tools; advanced DocSpace features like custom metadata fields or webhook configuration require the full REST API.
Who on my team should connect the ONLYOFFICE integration?
Whoever owns the API key. ONLYOFFICE ties permissions to the key, so if your team lead has a key scoped to all rooms, they should connect it in Switchy. Other members can then invoke the MCP in shared chats, and actions run under that key's identity and quota.