Read and write VisiGrid cloud spreadsheets from your
agent. Formulas you write are evaluated by the real VisiGrid engine before the
sheet is saved, so you can write =SUMIFS(...) and read the computed result
back in the next call rather than reimplementing the arithmetic.
Install from the marketplace, or add the server directly:
{
"mcpServers": {
"visigrid": { "url": "https://mcp.visigrid.app/mcp" }
}
}The server uses OAuth 2.0 with PKCE and dynamic client registration — there is no API key to paste. On first use your client opens the VisiGrid sign-in page, you approve access, and the token is stored by the client.
A free account is enough. Usage is bounded by the 100 MB storage limit on free plans, not by a paid gate.
| Tool | What it does |
|---|---|
list_sheets |
List the spreadsheets in your account |
create_spreadsheet |
Create a new spreadsheet |
import_spreadsheet |
Import an existing .xlsx or .csv |
get_workbook |
Workbook structure — tabs, dimensions, named ranges |
read_range |
Read an A1 range, with both display values and formulas |
write_cells |
Write values and formulas; evaluated before saving |
add_tab / rename_tab |
Add or rename a tab |
set_format |
Number formats, bold, fills, borders |
set_layout |
Column widths, row heights, frozen panes |
Ranges are A1 notation (Sheet1!A1:D20). Coordinates in responses are 0-based.
Batch your writes. One write_cells call with many cells is much faster
than many calls, and lands as a single entry in the user's undo history rather
than dozens.
Pass expected_revision. Every read returns a revision. Passing it back
with a write means a concurrent human edit is reported as revision_mismatch
instead of being silently overwritten — re-read and retry when that happens.
Inserting and deleting rows and columns are deliberately absent. Doing it correctly means shifting formula references, merges, chart ranges and conditional-format ranges, which belongs in the engine rather than in a server that would get it subtly wrong.
rename_tab refuses by default when a formula references the tab, because
VisiGrid does not yet rewrite those references and they would become #REF!.
Pass force if you want it anyway.
It operates on spreadsheets in your VisiGrid account, so an agent can work with no machine of yours involved.
Separately, the VisiGrid desktop app ships vgrid mcp, which drives a live
window on your own computer over stdio. The tool names match, so a prompt
written against one generally works against the other.
- Docs — https://docs.visigrid.app/connector/
- Support — support@visigrid.app
MIT — see LICENSE. This covers the plugin manifest in this repository. The VisiGrid service it points at is a hosted product, and the VisiGrid desktop application is licensed separately under the AGPL.