Aspose.PDF Cloud MCP Server
Merge PDF documents, convert PDF to Word and read document properties through Aspose.PDF Cloud's REST API, from any MCP-compatible AI client.
Install Aspose.PDF Cloud
You need Python 3.11 or later. Install the server into a virtual environment; the first package is the shared file-tool library that every Aspose Cloud MCP server depends on.
python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate pip install \ git+https://github.com/aspose-cloud/aspose-storage-cloud-python-mcp.git@v1.0.5 \ git+https://github.com/aspose-cloud/aspose-pdf-cloud-python-mcp.git@v1.1.4
This puts the aspose-pdf-mcp command into the virtual environment.
Configure Aspose.PDF Cloud in your AI client
Create an application on your Aspose Cloud dashboard to get a Client ID and Client Secret (a free evaluation tier is available). The server reads them from its environment when it starts; they are never passed as a tool argument. ASPOSE_FILES_PATH is the folder on your computer that the server may read files from and write results to.
{
"mcpServers": {
"pdf": {
"command": "C:\\path\\to\\.venv\\Scripts\\aspose-pdf-mcp.exe",
"env": {
"ASPOSE_CLIENT_ID": "your-client-id",
"ASPOSE_CLIENT_SECRET": "your-client-secret",
"ASPOSE_FILES_PATH": "C:\\Users\\you\\Documents\\aspose-files"
}
}
}
}
// macOS / Linux: "command": "/path/to/.venv/bin/aspose-pdf-mcp"{
"servers": {
"pdf": {
"type": "stdio",
"command": "/path/to/.venv/bin/aspose-pdf-mcp",
"env": {
"ASPOSE_CLIENT_ID": "your-client-id",
"ASPOSE_CLIENT_SECRET": "your-client-secret",
"ASPOSE_FILES_PATH": "/home/you/aspose-files"
}
}
}
}// Same JSON shape as VS Code above — use the config path for your tool: // ~/.cursor/mcp.json · Cline settings · Windsurf mcp_config.json
Example prompts
- Upload report.pdf, tell me its title and author, then convert it to Word and download it.
- Merge 4pages.pdf and 5pages.pdf and tell me how many pages the result has.
Available tools (3)
Every tool this server exposes, straight from its own tool manifest.
| Tool | Description | Parameters |
|---|---|---|
pdf_convert_to_doc |
Converts a PDF file stored in Aspose Cloud storage to a Word document (DOC or DOCX) and returns the converted file content. Read-only |
filename: str (required), folder_name: str | None, storage_name: str | None, output_filename: str | None, return_base64: bool
|
| prompt: convert invoice.pdf to a Word document using aspose pdf cloud mcp | ||
| prompt: convert scan.pdf to docx and save as scan-editable.docx using aspose pdf cloud mcp | ||
| prompt: convert invoice.pdf from the invoices folder of my MyStorage storage to Word and return it as base64 text using aspose pdf cloud mcp | ||
pdf_merge_documents |
This tool merges a list of PDF documents into a single PDF file with a specified result name. Dry run |
filename: str (required), merge_request: dict[str, Any] (required), storage_name: str | None, folder_name: str | None, dry_run: bool
|
| prompt: merge part1.pdf, part2.pdf and part3.pdf into full-report.pdf using aspose pdf cloud mcp | ||
| prompt: merge jan.pdf and feb.pdf from the reports folder of my MyStorage storage into q1.pdf using aspose pdf cloud mcp | ||
| prompt: do a dry run of merging cover.pdf and body.pdf into book.pdf using aspose pdf cloud mcp | ||
pdf_get_document_properties |
Retrieves the metadata properties of a specified PDF document from Aspose Cloud storage. Read-only |
filename: str (required), folder_name: str | None, storage_name: str | None
|
| prompt: show the author, title and creation date of brochure.pdf using aspose pdf cloud mcp | ||
| prompt: show the properties of brochure.pdf from the marketing folder of my MyStorage storage using aspose pdf cloud mcp | ||
Every server also includes four shared file tools (upload, download, list and delete), so a single server is enough for a complete upload, process, download workflow.