# Csv

> Csv is a freemium MCP server for files and documents. Converts CSV to JSON and JSON rows back to CSV, for AI agents that handle tabular data. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/csv
- **Repository:** https://github.com/pipeworx-io/mcp-csv
- **MCP Registry name:** io.github.pipeworx-io/csv
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents)
- **Listing updated:** 2026-11-18

## About

The README says this is a Model Context Protocol server exposing two tools: one parses RFC 4180 CSV into JSON objects or arrays, the other serializes JSON rows back to CSV. Quoted fields, escaped quotes and embedded commas or newlines are handled, and a delimiter option covers TSV-style files.

The server is published on npm as a local stdio bridge that forwards calls to a hosted Pipeworx gateway endpoint, and a streamable-HTTP remote is also listed. The vendor's pages describe the two conversion tools as keyless and offline, though the npm bridge itself needs network access to reach the gateway.

It suits developers and agent builders who want a model to read or produce spreadsheet-style data without writing parsing code. Connections without an API key are capped daily, and a free Pipeworx account raises that cap.

## Features

- **RFC 4180 CSV parsing:** Turns CSV text into JSON, using the first row as keys by default or returning plain arrays.
- **JSON to CSV serialization:** Builds a CSV header from the union of object keys and quotes fields only where needed.
- **Custom delimiters:** Accepts a delimiter setting so tab-separated and other delimited files can be parsed.
- **Remote and local install:** Available as a hosted streamable-HTTP endpoint or as an npm stdio package.
- **Optional API key:** Anonymous use is rate-capped daily; a free key raises the limit.

## Good for

- Letting an assistant read an uploaded CSV export as structured JSON
- Converting API responses or database rows into CSV for spreadsheet import
- Normalising delimited files before passing them to another tool
- Generating downloadable CSV reports from agent-produced data

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http csv https://gateway.pipeworx.io/csv/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/csv/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "csv": {
      "url": "https://gateway.pipeworx.io/csv/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "csv": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/csv/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "csv": {
      "serverUrl": "https://gateway.pipeworx.io/csv/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "csv": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/csv/mcp"
    }
  }
}
```

## Tools

- `csv_to_json`: Parse RFC 4180 CSV into JSON, with optional header handling and delimiter setting.
- `json_to_csv`: Serialize an array of JSON objects or arrays to CSV with correct quoting.

## FAQ

### Does the CSV tool need an API key?

The vendor pages say the two conversion tools are keyless. An optional Pipeworx key raises the daily call cap.

### Can it parse TSV files?

Yes, the README says setting the delimiter option handles TSV and similar formats.

### Does the npm package work offline?

No. The README states the npm bridge forwards every call to the gateway and has no offline mode.

### Which tools does the endpoint list?

Besides csv_to_json and json_to_csv, the README says the endpoint also lists shared Pipeworx meta-tools such as ask_pipeworx.

### Is Csv free?

Csv has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Csv to Claude Code?

Run this command in your terminal: claude mcp add --transport http csv https://gateway.pipeworx.io/csv/mcp

### What are the best alternatives to Csv?

The closest alternatives to Csv are Decant: convert CSV, XLSX and PDF to JSON; web page extraction that honours robots.txt, CSV File Tools, json-shaper-lite, jsonloupe and Parserail MCP.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Decant: convert CSV, XLSX and PDF to JSON; web page extraction that honours robots.txt](https://ai-powered.com/mcp/decant-convert-csv-xlsx-and-pdf-to-json-web-page-extraction): Decant: convert CSV, XLSX and PDF to JSON; web page extraction that honours robots.txt is a free MCP server for files and documents.
- [CSV File Tools](https://ai-powered.com/mcp/csv-file-tools): CSV File Tools is a free MCP server for files and documents.
- [json-shaper-lite](https://ai-powered.com/mcp/json-shaper-lite): json-shaper-lite is an open-source MCP server for files and documents.
- [jsonloupe](https://ai-powered.com/mcp/jsonloupe): jsonloupe is an open-source MCP server for developer tools.
- [Parserail MCP](https://ai-powered.com/mcp/parserail-mcp): Parserail MCP is a paid MCP server for files and documents.
- [Conversion Tools](https://ai-powered.com/mcp/conversion-tools): Conversion Tools is a freemium MCP server for files and documents.
- [Markdown](https://ai-powered.com/mcp/markdown-2): Markdown is a freemium MCP server for files and documents.
- [Docparser MCP by usefulapi](https://ai-powered.com/mcp/docparser-mcp-by-usefulapi): Docparser MCP by usefulapi is a freemium MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/csv
