Allows AI agents to read and write WiseGrid sheets, rows, columns, and reports directly from a conversation.
Also known as RyanKramer/wisegrid-mcp
- Stars
- 0
- Tools
- 9
- Downloads, 30 days
- 80
- Latest version
- 0.1.0
- Last commit
- Aug 27, 2026
- License
- MIT
What is WiseGrid MCP?
WiseGrid allows AI agents to read and write WiseGrid sheets, rows, columns, and reports directly from a conversation. It exposes 9 tools, such as whoami, list_sheets, get_sheet.
Summary generated from the project's README
About WiseGrid MCP server
Managing WiseGrid sheets and reports directly from an AI conversation allows developers to interact with real data using Claude or Cursor. This server provides tools to list sheets, page through rows, and execute reports. It is designed for users who need to perform data operations like bulk inserting up to 2000 rows or updating specific cell values without leaving their chat interface.
To use this server, you must provide a WISEGRID_API_KEY via environment variables. You can also specify a WISEGRID_BASE_URL if you are using a self-hosted instance. The server uses version-checked updates to prevent silent overwrites during concurrent edits, ensuring that changes are only applied if the row version matches what was originally read.
Because cells are keyed by column ID rather than name, the server includes tools like list_columns to help the agent identify the correct keys. For safety, deleting a row requires a confirmation flag because the action removes the entire subtree and cannot be undone.
Written from the project's README. Every use case is checked against a quote from it.
How to install WiseGrid MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall WiseGrid MCP in Claude Code
$ claude mcp add --env 'WISEGRID_API_KEY=<YOUR_WISEGRID_API_KEY>' wisegrid-mcp -- uvx wisegrid-mcpInstall WiseGrid MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"wisegrid-mcp": {
"command": "uvx",
"args": [
"wisegrid-mcp"
],
"env": {
"WISEGRID_API_KEY": "<YOUR_WISEGRID_API_KEY>"
}
}
}
}Install WiseGrid MCP in VS Code
.vscode/mcp.json
{
"servers": {
"wisegrid-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"wisegrid-mcp"
],
"env": {
"WISEGRID_API_KEY": "<YOUR_WISEGRID_API_KEY>"
}
}
}
}Install WiseGrid MCP in VS Code CLI
$ code --add-mcp '{"name":"wisegrid-mcp","type":"stdio","command":"uvx","args":["wisegrid-mcp"],"env":{"WISEGRID_API_KEY":"<YOUR_WISEGRID_API_KEY>"}}'Install WiseGrid MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"wisegrid-mcp": {
"command": "uvx",
"args": [
"wisegrid-mcp"
],
"env": {
"WISEGRID_API_KEY": "<YOUR_WISEGRID_API_KEY>"
}
}
}
}Install WiseGrid MCP in Codex
$ codex mcp add wisegrid-mcp --env 'WISEGRID_API_KEY=<YOUR_WISEGRID_API_KEY>' -- uvx wisegrid-mcpInstall WiseGrid MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.wisegrid-mcp] command = "uvx" args = ["wisegrid-mcp"] [mcp_servers.wisegrid-mcp.env] WISEGRID_API_KEY = "<YOUR_WISEGRID_API_KEY>"
Install WiseGrid MCP in Gemini CLI
$ gemini mcp add -s user -e 'WISEGRID_API_KEY=<YOUR_WISEGRID_API_KEY>' wisegrid-mcp uvx -- wisegrid-mcpInstall WiseGrid MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"wisegrid-mcp": {
"command": "uvx",
"args": [
"wisegrid-mcp"
],
"env": {
"WISEGRID_API_KEY": "<YOUR_WISEGRID_API_KEY>"
}
}
}
}WiseGrid MCP tools 9
Detected from the READMEwhoamilist_sheetsget_sheetlist_columnslist_rowsadd_rowsupdate_rowupdate_rowsdelete_row
| whoami | — | |
| list_sheets | — | |
| get_sheet | — | |
| list_columns | — | |
| list_rows | — | |
| add_rows | — | |
| update_row | — | |
| update_rows | — | |
| delete_row | — |
Configuration
WISEGRID_API_KEYRequiredSecretWiseGrid API key (create one under Settings)
WISEGRID_BASE_URLOverride the API base URL for self-hosted instances
| Name | Description | |
|---|---|---|
| WISEGRID_API_KEY | WiseGrid API key (create one under Settings) | RequiredSecret |
| WISEGRID_BASE_URL | Override the API base URL for self-hosted instances |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableryankramer/wisegrid-mcp is public and reachablegithub.com/ryankramer/wisegrid-mcp ↗Pass
- Package names this repository as its sourcewisegrid-mcp names ryankramer/wisegrid-mcp as sourcepypi.org/project/wisegrid-mcp/ ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-08-27github.com/ryankramer/wisegrid-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from wisegrid-mcpPass
- No critical advisory in the package or its dependencies65 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model9 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubWiseGrid MCP
Read and write WiseGrid sheets from Claude, Cursor, or any MCP client. List sheets, page through rows, add and update records, and run reports — from inside a conversation.
Unlike the other servers in this family, these tools operate on your real data, so an API key is required.
Install
{
"mcpServers": {
"wisegrid": {
"command": "uvx",
"args": ["wisegrid-mcp"],
"env": {
"WISEGRID_API_KEY": "wg_live_xxx"
}
}
}
}
Or pip install wisegrid-mcp.
| Variable | Required | Purpose |
|---|---|---|
WISEGRID_API_KEY |
yes | Create one in WiseGrid under Settings |
WISEGRID_BASE_URL |
no | Override for self-hosted instances |
The key's scopes decide what these tools can reach. Grant read-only scopes if you only want the agent to look.
Tools
| Tool | What it does |
|---|---|
whoami |
The key's identity, scopes and rate limit — call this first when debugging |
list_sheets |
Sheets the key can see, cursor-paginated |
get_sheet |
Sheet + columns + first page of rows, in one call |
list_columns |
Column IDs, which cell dictionaries are keyed by |
list_rows |
Rows, cursor-paginated; each carries the version you need to update it |
add_rows |
Bulk insert, partial success, max 2000 |
update_row |
Update one row's changed cells, version-checked |
update_rows |
Bulk update, version-checked per row, max 2000 |
delete_row |
Delete a row and its subtree — requires confirm=True |
list_reports / get_report / run_report |
Reports and their rows |
Things that will bite you otherwise
Cells are keyed by column ID, not column name. {"101": "Acme Corp"}, not
{"Client": "Acme Corp"}. Call get_sheet or list_columns first.
Updates are version-checked. Every row carries a version; you pass the one
you read, and if the row changed in the meantime you get version_conflict
instead of a silent overwrite. That is a normal outcome to handle — re-read the
row, decide whether your change still applies, then retry. Blindly bumping the
version to force the write is how concurrent edits disappear.
update_row merges, update_rows overwrites. The single-row tool takes
only the cells you changed. The bulk tool replaces the row's cell set, so send
the full set you want the row to end up with.
delete_row takes the children too. It removes the row and its entire
subtree, it is not undoable through the API, and it requires confirm=True
for exactly that reason. Read the rows first.
Writes are idempotent. Each carries an Idempotency-Key, so a retry after a
timeout cannot double-apply. Rate limits are honoured via Retry-After.
Development
git clone https://github.com/RyanKramer/wisegrid-mcp
cd wisegrid-mcp
pip install -e .
WISEGRID_API_KEY=wg_live_xxx wisegrid-mcp
About
Built by WiseGrid. Full REST API reference at wisegrid.co/docs/api.
MIT licensed.
WiseGrid MCP questions
How do I add WiseGrid MCP to Claude Code?
Run claude mcp add --env 'WISEGRID_API_KEY=<YOUR_WISEGRID_API_KEY>' wisegrid-mcp -- uvx wisegrid-mcp in your terminal. Add --scope user to make it available in every project.
How do I add WiseGrid MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does WiseGrid MCP provide?
It exposes 9 tools, including whoami, list_sheets, get_sheet, list_columns, list_rows.
How do I identify columns when interacting with cells?
Cells are keyed by column ID rather than the column name. You should call get_sheet or list_columns first to retrieve the correct IDs.
What happens if I try to update a row that has changed since I last read it?
The system uses version-checking to prevent silent overwrites. If the row has changed, you will receive a version_conflict error.
Is it possible to accidentally double-apply a write due to a timeout?
No, writes are idempotent because each carries an Idempotency-Key, ensuring retries do not result in duplicate applications.
Does deleting a row also remove its associated data?
Yes, deleting a row removes the row and its entire subtree, and this action requires a confirmation flag because it is not undoable.