# WPS 365 MCP

> WPS 365 MCP lets your AI agent manage everything in a cloud office suite. Need to build a report, track collaborators, or organize folders across documents and spreadsheets? Your agent handles complex file operations—from listing all files to creating new ones—using natural conversation instead of a manual dashboard. It's full document control for the modern workspace.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** office-suite, cloud-storage, file-management, collaborative-editing, document-automation, spreadsheet-management

## Description

Managing collaborative projects means juggling dozens of files: presentations, massive sheets, policy docs. Instead of clicking through folder trees and worrying about version IDs, you simply talk to your agent. It treats WPS 365 like a natural extension of conversation. Your agent can look up all accessible documents, create new ones from scratch, import external data sources, or export the final product into PDF format—all without needing access to the underlying technical controls. This capability is powerful because everything happens within Vinkius; you get full visibility via Vinkius AI Analytics, so you always know exactly which files your agent accessed and what data flowed through. The result is a unified workflow where file management feels less like work and more like giving instructions.

## Tools

### create_file
Creates a brand new document or sheet within your WPS workspace.

### export_file
Converts an existing WPS file into standard external formats like PDF or DOCX.

### get_file_info
Retrieves specific details and metadata about a particular document.

### get_folder_content
Lists all the files and subfolders contained within a specified directory structure.

### get_org_info
Fetches high-level details about your entire organization's WPS account setup.

### import_file
Brings external content, such as a CSV or plain text file, into the active WPS document.

### list_collaborators
Identifies and lists every user who has permission to edit or view a specific file.

### list_files
Provides an exhaustive list of all documents currently stored in your WPS account.

### list_folders
Maps out the full hierarchy and names of every folder available to you.

### list_users
Retrieves a directory listing of all users registered in your organization's WPS account.

## Prompt Examples

**Prompt:** 
```
List all my collaborative documents on WPS.
```

**Response:** 
```
I've retrieved your WPS documents. You have 5 active files, including 'Quarterly Report' and 'Budget Sheet'. Which one would you like to view info for?
```

**Prompt:** 
```
Create a new spreadsheet titled 'Sales Forecast' in the 'Planning' folder.
```

**Response:** 
```
Done! I've created the spreadsheet 'Sales Forecast' inside the 'Planning' folder. You can now start adding your data. File ID: WPS-8821.
```

**Prompt:** 
```
Export the document 'Company Policy' to PDF.
```

**Response:** 
```
I've processed the export for you. Your document 'Company Policy' is now ready in PDF format. You can download it here: [link].
```

## Capabilities

### List all documents
Instantly retrieves metadata for every available document, sheet, and presentation in your workspace.

### Build new files
Creates blank or structured documents directly within the WPS environment using simple commands.

### Organize content
Imports external data, like CSVs or plain text, and structures it into a native document format.

### Check file details
Pulls specific information about any given file, including its current owner or creation date.

### Administer users
Retrieves a list of all organization members and checks who is collaborating on which document.

## Use Cases

### The Policy Audit
An Operations Manager needs to know every person who has viewed the HR Handbook. They ask their agent, which uses `list_collaborators`, and get a real-time list of all users with access rights.

### Quarterly Report Generation
A Project Coordinator needs to consolidate data from three different sources. The agent first uses `import_file` for the raw numbers, then `create_file` to make the presentation, and finally exports it using `export_file`.

### Finding Lost Assets
A Business Analyst is told a document exists but can't find it. The agent uses `list_files` across the entire workspace to pinpoint the exact file ID and location for them.

## Benefits

- Stop manually tracking file locations. You can ask your agent to `list_files` or use `list_folders` to immediately map the entire directory structure and find any doc in seconds.
- Don't worry about compatibility. When you finish a report, just tell the agent to run `export_file`, and it handles converting complex WPS formats into standard PDFs or DOCX files.
- Need to start fresh? Use `create_file` to generate a new spreadsheet or presentation on demand, letting your agent handle all the initial setup steps for you.
- When onboarding someone, checking permissions is painful. Simply ask the agent to run `list_collaborators` on a document to see who can edit it right now.
- Dealing with raw data? Instead of copy-pasting everything into a sheet, use `import_file` and let your agent structure external content automatically.

## How It Works

The bottom line is, you use one single AI client connection to run every document operation across WPS 365.

1. Subscribe to this MCP and input your WPS App ID and App Key into Vinkius.
2. Connect your preferred AI client (Claude, Cursor, etc.) to the Vinkius platform using that single connection point.
3. Tell your agent what you need—for example, 'List all documents in the Finance folder'—and it executes the commands.

## Frequently Asked Questions

**How do I list all my documents using the WPS 365 MCP? (list_files)**
Use `list_files` to get an exhaustive, real-time inventory of every single document. This tool bypasses manual folder browsing and gives you a complete count right away.

**Can I convert my WPS files to PDF with the WPS 365 MCP? (export_file)**
Yes, running `export_file` handles the conversion. You just specify the original file ID and the desired output format like PDF or DOCX.

**Which tool should I use to see who can edit a document? (list_collaborators)**
You need `list_collaborators`. This tool checks the internal security permissions of the file and tells you exactly which users have editing rights.

**What is the difference between listing folders and getting folder content? (get_folder_content vs list_folders)**
`list_folders` shows you the names of all the containers. `get_folder_content` goes deeper; it lists everything—both files and subfolders—that are actually inside a specific container.

**How do I use `list_users` to get a roster of everyone in my organization?**
It pulls a list of all active users within your WPS workspace. This is useful for auditing or building reports on who has access, giving you the full user count and their basic profile details.

**If I have external data, how do I use `import_file` in conjunction with `create_file`?**
You first call `create_file` to generate a new WPS document container. Then, the agent uses `import_file` to move your external content into that file seamlessly. This keeps your data organized and ready for collaboration.

**What specific metadata can I pull about one file using `get_file_info`?**
This tool retrieves deep details on a single document, including its size, creation date, and last time it was edited. You get forensic data points on any WPS file without having to open the actual content.

**How do I check the general system status of my company's setup using `get_org_info`?**
It provides a high-level overview of your entire WPS infrastructure. This is perfect for operations managers or leaders who need to audit overall settings and organizational structure without diving into individual files.

**How do I find my WPS App ID and Key?**
Log in to the [WPS Open Platform](https://open.wps.cn/), create an application in the Developer Console, and you will find your APPID and APPKEY in the credentials section.

**Can I read spreadsheet data through this server?**
Yes. While this server focuses on file management, you can use the `get_file_info` and specialized export tools to access document data for analysis.

**Does WPS 365 support PDF conversion?**
Yes. Using the `export_file` tool, you can specify 'pdf' as the output format to convert your Word or Excel documents into high-quality PDF files.