Csvbox MCP server
io.github.csvbox-io/csvbox-mcp-server·v1.0.1·1 starsCSVBox MCP server for creating, updating, validating and generating CSVBox importer sheets.
1 stars45 downloads/wk
Reviews
Write oneNobody has reviewed Csvbox yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Csvbox tools (9, 5 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
create_importer_from_promptwrite actionGenerate a COMPLETE CSVBox sheet from a natural-language prompt via a configured LLM, validate it locally, then create it via POST /1.1/sheet. Returns { generated_schema, source, validation, api_response }. Aborts (no API call) if no LLM provider is configured or if validation fails. Requires ANTHROPIC_API_KEY or OPENAI_API_KEY plus CSVBox credentials.
create_sheetwrite actionCreate a new CSVBox sheet via POST /1.1/sheet. Input: { sheet }. Returns the API response.
generate_import_codeGenerate complete CSVBox importer integration code for a framework (vanilla-js, react, vuejs2 [Vue 2], vuejs3 [Vue 3], angular [Angular 8-13], angular2 [Angular 14+]). Input: { framework }. Replace the license key placeholder with your sheet's license key.
generate_sheet_functionsAuthor CSVBox virtual_columns, validation_functions, and data_transforms from a natural-language prompt using a configured LLM. Does NOT call the CSVBox API — it returns JSON so you can REVIEW the generated JavaScript before applying it with patch_sheet. Collections the request does not imply are omitted, never returned as empty arrays. Returns { virtual_columns?, validation_functions?, data_trans
generate_sheet_jsonGenerate a COMPLETE CSVBox sheet (title, sheet_columns, destinations, webhooks, security_settings, steps) from a natural-language prompt using a configured LLM. Does NOT call the CSVBox API. Returns { sheet, source, validation }. Requires ANTHROPIC_API_KEY or OPENAI_API_KEY; without one it returns an error pointing to the create_csvbox_sheet MCP prompt. Input: { prompt }.
patch_sheetwrite actionPartially update a CSVBox sheet via PATCH /1.1/sheet/{sheet_license_key}. Sends only the changes object. Input: { sheet_license_key, changes }. Returns the API response. PATCH MERGES: only the items you list are touched and nothing is deleted implicitly, so an empty array is a no-op. Items in virtual_columns, validation_functions and data_transforms are matched by column_name / function_name / tra
submit_filewrite actionSubmit a file for import via POST /1.1/file. Provide exactly one of public_file_url (JSON submission) or file_base64 + file_name (multipart direct upload — file_base64 is decoded server-side and sent to CSVBox as true binary multipart content, never as a base64 string). Input: { sheet_license_key, public_file_url? | (file_base64?, file_name?), file_sheet_name?, user?, options?, dynamic_columns? }.
update_sheetwrite actionReplace an existing CSVBox sheet via PUT /1.1/sheet/{sheet_license_key}. Input: { sheet_license_key, sheet }. Returns the API response. DESTRUCTIVE: PUT is authoritative for every collection it sends — items listed are created or updated in place, and any existing item the array does not name is DELETED. This applies to virtual_columns, validation_functions and data_transforms: sending an empty ar
validate_schema
Public scan report
scanner v0.1.10 · 2026-10-31 · same rubric, same numbers if you re-run it
- Code scan39 source files scanned13/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 8 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
Findings (1)
- highNetwork call to a paste/tunnel/webhook host
net.suspicious-hostdist/prompts/sheet-system-prompt.js: …pi and import-complete event webhook as https://webhook.site/... with headers samsung-mobile-api-key…
How Csvbox compares
Against every graded Productivity MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 66/100
- higher than 18% of 1,299 Productivity servers
- Tools
- 9
- the typical Productivity server has 7
- Tools that change things
- 56%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 50% of 854 Productivity servers
- Downloads a week
- 45
- more than 34% of 427 Productivity servers with a package
What its tools let an agent do: 1 read · 5 create · 3 change
Install Csvbox in Claude Code, Cursor or VS Code
Runs npx -y @csvbox/mcp-server on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add csvbox-mcp-server -- npx -y @csvbox/mcp-server
What the publisher says
From the Csvbox repository's README, as published. We do not edit it. Read it on GitHub
csvbox-mcp-server
A universal Model Context Protocol (MCP) server for CSVBox. It exposes CSVBox importer-sheet management as MCP tools so you can create, replace, patch, generate, validate, and scaffold importers from any MCP-compatible client — Claude Desktop, Cursor, Windsurf, Roo Code, Cline, VS Code, ChatGPT MCP, and more.
Runs over stdio, so it works the same way in every client.
Tools
CSVBox currently has no GET or LIST endpoints, so there are intentionally no getsheet / listsheet tools.
It also exposes two MCP prompts:
Prompt → sheet generation
generatesheetjson and createimporterfromprompt use an LLM to convert a free-form request into a complete CSVBox sheet — title, sheetcolumns, destinations, webhooks, security_settings, and steps. Only actual data fields become columns; destinations, webhooks, domains, regions, file-upload and step settings are placed in their proper configuration sections, never turned into columns. There are three tiers:
- Server LLM — when ANTHROPICAPIKEY or OPENAIAPIKEY is set, the server calls the LLM directly. Works in MCP Inspector and headless.
- MCP prompt (createcsvboxsheet) — when you have no server key, host clients (Cursor, Claude Desktop, Cline) run the generation with their own model, then call validateschema and createsheet. Free.
- None configured — generatesheetjson returns a structured "no LLM provider configured" error pointing to the MCP prompt, and createimporterfromprompt does not call the CSVBox API. There is no** regex fallback.
Category / module expansion
The generator runs in one of two modes, chosen automatically from the prompt:
- Extraction (default) — the prompt names concrete fields (e.g. "columns name, email, phone"). Only those become columns; nothing is invented.
- Expansion — the prompt names business modules / categories as a list (e.g. "modules for: Company Information, Suppliers, Payroll, Invoice"), asks for a comprehensive/detailed schema, or asks for a column count ("at least 100 columns"). Each named module is expanded into several realistic, prefixed, correctly-typed columns (e.g. Suppliers → supplierid, suppliername, suppliergstin, supplieremail, …). An explicit minimum count is honored and every column_name is globally unique.
Data types and validations are inferred from the field names and any requested types:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Csvbox: common questions
- Is Csvbox MCP server safe?
- With care: it is graded C, so read the findings first (66/100). Read the Csvbox safety report
- How do I install Csvbox?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Csvbox need an API key?
- Yes. The registry entry asks for
CSVBOX_API_KEY,CSVBOX_API_SECRET,OPENAI_API_KEY,ANTHROPIC_API_KEY. - Is Csvbox maintained?
- The last commit was 12 days ago (2026-10-23). The latest release is v1.0.1.
- What can I use instead of Csvbox?
- Servers from other publishers that do the same job: MCP Server for Excel, Gsheets MCP server and Sheets MCP server.
- How does Csvbox compare with other Productivity MCP servers?
- safety score 66/100 (higher than 18% of 1,299 Productivity servers); tools 9 (the typical Productivity server has 7); tools that change things 56% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Csvbox
Same job from other publishers: the closest match first, then the best rated.
- MCP Server for ExcelExcel automation for AI - Sheets, Power Query, DAX, VBA, Tables, Ranges and more. Windows only.not reviewedEstablishedA
- GsheetsMCP server for Google Sheets API — read, write, format, batch operations.not reviewedEstablishedB
- Sheets MCPGoogle Sheets for agent workflows in Claude Code and Claude Desktop: APIs, files, schedules, undo.not reviewedEstablishedA
- jevreelSearch and understand videos without embeddings: contact sheets plus Jev typed decisions.not reviewedGrowingB
- MiroOfficial Miro MCP server - Supports context to code and creating diagrams, docs, and data tables.not reviewedGrowingA