Aspose.Cells Cloud MCP Server
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Aspose.Cells Cloud MCP ServerConvert the workbook 'sales.xlsx' to PDF and download it."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Aspose.Cells Cloud MCP Server
Spreadsheet processing — convert, create, merge, split, replace text, and read workbook properties/worksheets.
An MCP server exposing Aspose.Cells Cloud's REST API as typed,
agent-callable tools. Also bundles Aspose Storage Cloud's core file operations
(storage_upload_file/storage_download_file/storage_list_files/storage_delete_file), so a
client connected to only this server can complete a full upload -> process -> download workflow with
no second server connection.
Handles: XLSX, XLS, CSV, ODS.
Requirements
Python 3.11 or later
An Aspose Cloud account (free evaluation tier available) - you'll need a Client ID and Client Secret from your dashboard's Applications page
An MCP-compatible AI client (Claude Desktop, Claude Code, VS Code, Cursor, Cline, Windsurf, etc.)
Related MCP server: Excel MCP Server
Setup
1. Create a virtual environment and install
python -m venv .venv
# Windows:
.venv\Scripts\activate
# macOS / Linux:
source .venv/bin/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-cells-cloud-python-mcp.git@v2.2.0This installs the aspose-cells-mcp command into your virtual environment. The first package is the shared file-tool library (upload, download, list, delete) that every Aspose Cloud MCP server depends on; it is not on PyPI, so it is installed from GitHub in the same command.
2. Configure your AI client
Three environment variables are required. The first two come from your Aspose Cloud dashboard's Applications page; the third is a folder you create on your own computer (see Your files folder below):
Variable | Value |
| Your application's Client ID |
| Your application's Client Secret |
| Full path of the folder on your computer where your input files are placed and results are saved |
Credentials are never passed as a tool parameter - the server resolves them once at launch from these environment variables, exchanges them for a short-lived OAuth2 token, and caches/refreshes it transparently.
Your files folder (ASPOSE_FILES_PATH)
Create a folder on your computer (for example C:\Users\you\Documents\aspose-files on Windows, or
/home/you/aspose-files on macOS/Linux) and set ASPOSE_FILES_PATH to its full path. It is the one
place this server reads your files from and writes results to:
Input: put the document you want processed in that folder, then ask your assistant to upload it with
storage_upload_file, giving only the bare filename (for examplereport.docx). The upload sends it to your Aspose Cloud Storage, where the processing tools read it. Subfolders and full paths are rejected.Output:
storage_download_filesaves a result from Cloud Storage back into the same folder, and its reply contains the full local path of the saved file.The file and folder arguments of the other tools name locations in your Aspose Cloud Storage, not your computer.
Claude Desktop
Config file location:
Platform | Path |
Windows |
|
macOS |
|
{
"mcpServers": {
"cells": {
"command": "C:\\path\\to\\.venv\\Scripts\\aspose-cells-mcp.exe",
"env": {
"ASPOSE_CLIENT_ID": "your-client-id",
"ASPOSE_CLIENT_SECRET": "your-client-secret",
"ASPOSE_FILES_PATH": "C:\\Users\\you\\Documents\\aspose-files"
}
}
}
}On macOS/Linux, use /path/to/.venv/bin/aspose-cells-mcp instead. Fully quit and restart Claude Desktop after
editing.
VS Code (.vscode/mcp.json), Cursor (~/.cursor/mcp.json), Cline, Windsurf
Same shape, under a "servers" key instead of "mcpServers" for VS Code:
{
"servers": {
"cells": {
"type": "stdio",
"command": "/path/to/.venv/bin/aspose-cells-mcp",
"env": {
"ASPOSE_CLIENT_ID": "your-client-id",
"ASPOSE_CLIENT_SECRET": "your-client-secret",
"ASPOSE_FILES_PATH": "/home/you/aspose-files"
}
}
}
}Available tools
Tool | What it does | Read-only | Dry-run |
| The tool retrieves the description of the auto‑filter configuration for a specified worksheet within a workbook stored in Aspose Cloud. | yes | - |
| The tool deletes a date filter that has been applied to a specific column in a worksheet of a given Excel workbook stored in Aspose Cells. | no | yes |
| The tool deletes the auto‑filter applied to a specific column in a given worksheet of an Excel workbook stored in Aspose Cloud. | no | yes |
| The tool retrieves descriptions of cells from a specified worksheet in a spreadsheet file stored in Aspose Cloud. | yes | - |
| Sets the value and data type of a specified cell range in a worksheet of an existing Excel file stored in Aspose Cloud. | no | yes |
| This tool retrieves the full style description of a specific cell in a worksheet stored in Aspose Cloud. | yes | - |
| The tool updates the visual style of a single cell identified by its A1‑style address in a specified worksheet of an Excel workbook stored in Aspose Cloud storage. | no | yes |
| The tool retrieves the HTML representation of a specific cell—including its data and formatting—from an Excel workbook stored in Aspose Cloud. | yes | - |
| The tool fetches detailed metadata for the columns of a specified worksheet in a workbook stored in Aspose Cells Cloud. | yes | - |
| The tool inserts a specified number of new columns into a given worksheet of an Excel file at the indicated column index. | no | yes |
| The tool deletes a specified number of consecutive columns starting at a given column index from a worksheet in an Excel file stored in Aspose Cloud. | no | yes |
| The tool returns the list of row descriptions for a given worksheet in an Excel file stored in Aspose Cloud. | yes | - |
| Deletes a contiguous block of rows from a specified worksheet in an Excel file stored on Aspose Cloud. | no | yes |
| The tool deletes a specific row from a worksheet in an Excel file stored in Aspose Cloud. | no | yes |
| Inserts a new row at the specified index into a worksheet of an Excel file stored in Aspose Cloud. | no | yes |
| This tool checks the health status of the Aspose.Cells Cloud service. | yes | - |
| Retrieves the list of chart descriptions defined in a specific worksheet of an Excel file stored in Aspose Cloud. | yes | - |
| The tool deletes all chart objects from a specified worksheet in an Excel file stored in Aspose Cloud. | no | yes |
| Retrieves the legend description for a specified chart within a worksheet of an Excel file stored in Aspose Cloud. | yes | - |
| Updates the legend of a specified chart in a worksheet of an Excel file stored in Aspose Cloud. | no | yes |
| Deletes the legend from a specified chart in a worksheet of an Excel file stored in Aspose Cloud. | no | yes |
| This tool retrieves the title description of a specified chart in a worksheet of an Excel file stored in Aspose Cloud. | yes | - |
| Updates the title of a specific chart in a worksheet file stored in Aspose Cloud. | no | yes |
| Deletes the title of the specified chart in a worksheet of a spreadsheet file stored in Aspose Cloud. | no | yes |
| The tool retrieves the series‑axis description of a specific chart in an Excel workbook. | yes | - |
| Retrieves the category axis information for a specified chart in a worksheet of an Excel file stored in Aspose Cloud. | yes | - |
| Updates the category axis of a specific chart in an Excel worksheet stored in Aspose Cloud. | no | yes |
| The tool retrieves the configuration of the value axis for a specific chart stored in an Excel workbook on Aspose Cloud. | yes | - |
| The tool updates the value‑axis configuration of a specific chart in an Excel workbook stored in Aspose Cloud. | no | yes |
| The tool retrieves a list of all conditional formatting definitions applied to a specified worksheet in an Excel file stored in Aspose Cloud. | yes | - |
| Removes all conditional formatting rules from a specified worksheet in a given Excel file stored in Aspose Cloud. | no | yes |
| The tool adds a conditional formatting rule to a specified worksheet in an existing workbook file. | no | yes |
| Deletes a specified cell area from the conditional formatting rules of a worksheet in an Excel file stored in Aspose Cloud. | no | yes |
| This tool downloads a workbook from Aspose.Cells storage, optionally converting it to a selected format and applying various export options. | yes | - |
| Creates a new Excel workbook in Aspose.Cells cloud storage, optionally using a template and/or smart‑marker data, with options to control overwriting and the target fold… | no | yes |
| Retrieves the list of hyperlink definitions present in a specified worksheet of an Excel file stored in Aspose Cloud. | yes | - |
| Deletes all hyperlinks from a specified worksheet in an Excel file stored in Aspose Cloud. | no | yes |
| Gets the metadata descriptions of all ListObjects (tables) defined in a specified worksheet of an Excel file stored on Aspose Cloud. | yes | - |
| Deletes all ListObjects from the specified worksheet in the given Excel file stored in Aspose Cloud. | no | yes |
| The tool retrieves the collection of OLE object descriptions from a specified worksheet within a workbook stored in Aspose Cloud. | yes | - |
| Deletes all OLE objects from a specified worksheet in an Excel file stored in Aspose Cloud. | no | yes |
| This tool retrieves the descriptions of all vertical page breaks in a specified worksheet of a workbook stored in Aspose Cloud. | yes | - |
| Deletes all vertical page breaks from the specified worksheet in a workbook, optionally removing only the break at a given column index. | no | yes |
| Retrieves the list of horizontal page break definitions for a specified worksheet in a given workbook. | yes | - |
| Deletes horizontal page breaks from a specified worksheet in a workbook, optionally removing only the break at a given zero‑based row index. | no | yes |
| The tool retrieves the page‑setup configuration for a specific worksheet in a given Excel file stored in Aspose Cloud. | yes | - |
| Updates the page‑setup settings of a specified worksheet in an existing Excel file stored in Aspose Cloud. | no | yes |
| Deletes any existing header and footer from the specified worksheet in an Excel file stored in Aspose Cloud. | no | yes |
| The tool retrieves the page‑header configuration for a specified worksheet in a spreadsheet file stored in Aspose Cloud. | yes | - |
| This tool updates the header of a specific worksheet in an Excel file stored on Aspose Cloud. | no | yes |
| The tool retrieves the page footer configuration for a specified worksheet in a given Excel file stored in Aspose Cloud. | yes | - |
| Updates the footer of a specific worksheet in an Excel file stored in Aspose Cloud. | no | yes |
| The tool returns metadata describing each picture embedded in a specified worksheet of an Excel file stored in Aspose Cloud. | yes | - |
| Deletes all picture objects from the specified worksheet in a workbook stored in Aspose Cloud. | no | yes |
| Retrieves the list of pivot tables defined in a specified worksheet of an Aspose.Cells workbook. | yes | - |
| Deletes all pivot tables from the specified worksheet of the given Excel file stored in Aspose Cloud. | no | yes |
| The tool retrieves the description of a specific pivot field from a PivotTable in an Excel file stored in Aspose Cloud. | yes | - |
| Deletes a specified pivot field from a pivot table in an Excel workbook stored in Aspose.Cells Cloud. | no | yes |
| The tool fetches the list of PivotTable filter definitions that are applied to a specified PivotTable within a worksheet of an Excel file stored on Aspose Cloud. | yes | - |
| The tool deletes all pivot filters from a specified PivotTable in an Excel worksheet stored in Aspose.Cells Cloud. | no | yes |
| The tool fetches the collection of document properties defined for a given Excel workbook. | yes | - |
| Deletes all custom document properties and resets built‑in document properties for the specified workbook. | no | yes |
| Retrieves the value and details of a specific document property from an Excel workbook stored in Aspose Cloud. | yes | - |
| The tool removes the encryption settings from a specified Excel workbook stored in Aspose Cloud, thereby decrypting the file. | no | yes |
| The tool removes password‑based protection from a specified Excel workbook stored in Aspose Cloud. | no | yes |
| This tool removes write protection from a specified Excel workbook so it can be edited. | no | yes |
| Retrieves the values of the cells that lie within a specified range of a worksheet in an Excel file stored in Aspose Cloud. | yes | - |
| Assigns a specified value to every cell within a defined range of a worksheet in an Excel workbook, optionally converting the value’s data type and resetting the cells’… | no | yes |
| Deletes a specified range of cells from a worksheet in a workbook and shifts the remaining cells according to the chosen shift option. | no | yes |
| Retrieves the list of shape descriptions from a specified worksheet in an Excel file stored in Aspose Cloud. | yes | - |
| Deletes all shapes from a specified worksheet in an Excel file stored in Aspose Cloud. | no | yes |
| Fetches the metadata descriptions of all sparkline groups defined in a specified worksheet of an Excel file stored in Aspose Cloud. | yes | - |
| Deletes all sparkline groups from a specified worksheet in an Excel file. | no | yes |
| The tool retrieves the default style description of a specified Excel workbook stored in Aspose Cloud. | yes | - |
| This tool calls the Aspose Cells API to retrieve every text item contained in a specified workbook file. | yes | - |
| The tool retrieves the list of named ranges defined in a specified Excel workbook stored in Aspose Cloud. | yes | - |
| Deletes all named ranges from the specified workbook file. | no | yes |
| This tool retrieves the current value stored in a specified named range of a workbook. | yes | - |
| The tool merges a specified source workbook into a target workbook stored in Aspose.Cells cloud storage. | no | yes |
| The tool replaces every occurrence of a specified text string with a new text string throughout a workbook file stored in Aspose.Cells Cloud. | no | yes |
| The tool splits a workbook file into separate files according to a chosen output format, optionally limiting the worksheet range and controlling image resolution or nami… | no | yes |
| Retrieves the workbook settings for a specified Excel file stored in Aspose Cloud storage. | yes | - |
| Updates the workbook settings of a specified Excel file stored in Aspose Cloud. | no | yes |
| The tool deletes any background image set in a workbook file stored in Aspose.Cells Cloud. | no | yes |
| Retrieves the total number of printable pages in a specified Excel workbook stored in Aspose Cloud. | yes | - |
| Retrieves all styles defined in the specified Excel workbook. | yes | - |
| Retrieves the list and basic metadata of all worksheets contained in a specified Excel workbook. | yes | - |
| Deletes all worksheets in the specified workbook that satisfy the provided matching conditions. | no | yes |
| The tool retrieves a specific worksheet from a workbook and returns its contents exported in the requested file format. | yes | - |
| Adds a new worksheet with a specified name to an existing workbook file. | no | yes |
| Removes protection from a specified worksheet in an existing Excel file stored in Aspose Cloud. | no | yes |
| The tool retrieves every text item (such as cell values, comments, and other textual objects) from a specified worksheet in a given workbook stored in Aspose Cloud. | yes | - |
| Retrieves all comments defined in a specified worksheet of a spreadsheet file stored in Aspose Cloud. | yes | - |
| The tool removes every comment from a given worksheet in the specified Excel file stored in Aspose Cloud. | no | yes |
| Adds a comment to a specified cell in a worksheet of an Excel file stored in Aspose Cloud. | no | yes |
| Retrieves the list of merged cell ranges defined in a specified worksheet of a workbook stored in Aspose Cloud. | yes | - |
| This tool evaluates a specified Excel formula in a given worksheet of a workbook stored in Aspose Cloud and returns the calculated result. | yes | - |
| Removes the background image from a specific worksheet in an Excel file stored in Aspose Cloud. | no | yes |
| Unfreeze the specified rows and columns in a worksheet of an Excel file stored in Aspose Cloud. | no | yes |
| Fetches the collection of named range descriptions from all worksheets in the specified Excel file. | yes | - |
| Retrieves the total number of printable pages in a specified worksheet of an Excel file stored in Aspose Cloud. | yes | - |
| The tool retrieves the collection of validation descriptions defined in a specified worksheet of an Excel workbook stored in Aspose Cloud. | yes | - |
| Deletes all data validation rules from a specified worksheet in a given Excel workbook stored in Aspose Cloud. | no | yes |
| Downloads a file from Aspose Cells cloud storage and returns its binary data. | yes | - |
| Uploads a local file to a specified location in Aspose Cells cloud storage. | no | yes |
| Deletes a file from Aspose.Cells cloud storage. | no | yes |
| Copies a file from one location in Aspose Cloud storage to another location. | no | yes |
| The tool moves an existing file from one location to another within Aspose Cells Cloud storage. | no | yes |
| Gets a list of all files and sub‑folders contained in a given folder in Aspose Cloud storage. | yes | - |
| Creates a new folder at the specified path in Aspose Cells Cloud storage. | no | yes |
| Deletes a specified folder from Aspose Cells Cloud storage, optionally removing all contained subfolders and files. | no | yes |
| Copies a folder from a specified source location to a specified destination location in Aspose Cells cloud storage. | no | yes |
| Moves a folder from a specified source path to a specified destination path in Aspose Cells cloud storage. | no | yes |
| The tool checks whether a storage container with a given name exists in Aspose.Cells Cloud. | yes | - |
| The tool checks whether a specified file or folder is present in Aspose.Cells Cloud storage. | yes | - |
| Retrieves the current disk usage statistics for a specified Aspose.Cells storage. | yes | - |
| The tool retrieves the list of version metadata for a specified file stored in Aspose.Cells cloud storage. | yes | - |
Every mutating tool marked "yes" under Dry-run accepts a dry_run=true parameter to preview
the change without applying it.
Tool errors use a fixed taxonomy (bad input / auth failure / server error / rate limited), returned as structured MCP tool errors - never a silent failure or a raw exception message.
Part of the Aspose Cloud MCP family
One MCP server per Aspose Cloud product, published under github.com/aspose-cloud.
This server depends on aspose-storage-core-mcp
for its bundled storage tools — that repo is a shared library, not a standalone server (there's no
real Aspose Cloud API route for storage on its own; every real storage call goes through some
product's own gateway, this one included).
License
MIT (see LICENSE) — covers only this repository's own MCP wrapper/integration code.
It does not cover, and grants no rights to, the Aspose Cloud product or API themselves, which
remain governed entirely by Aspose's own product and usage terms.
A valid Aspose Cloud account and subscription/credentials are required to actually call the API,
regardless of this code's license.
This server cannot be deployed
Maintenance
Related MCP Connectors
Create, review and edit Word, PowerPoint, Excel and PDF documents from any AI agent.
Create and manage documents, spreadsheets, and presentations from your AI assistant.
Convert XLSX spreadsheets to and from XLS, CSV, PDF, JPG, HTML and ODS.
PDF tools for agents: compress to a size, Arabic + English OCR, Office conversion, JSON extraction.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to read, write, and manipulate Excel files through comprehensive spreadsheet operations. Supports file management, data querying, worksheet operations, formula calculations, and includes security features like path validation and automatic backups.2MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to create, read, and manipulate Excel files without requiring Microsoft Excel installation. Supports comprehensive spreadsheet operations including formulas, formatting, charts, pivot tables, and data validation.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to create, read, and modify Excel workbooks without requiring Microsoft Excel, supporting operations like formulas, charts, pivot tables, formatting, and data validation.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to create, read, and manipulate Excel workbooks without Microsoft Excel installed, supporting formulas, formatting, charts, pivot tables, and data validation operations.MIT