# json-shaper-lite

> json-shaper-lite is an open-source MCP server for files and documents. Turn key: value notes, CSV/TSV and Markdown tables into typed JSON, offline. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Starting price:** $5 a month
- **Platforms:** CLI, Windows, macOS, Linux
- **Website:** https://tidybytetools.github.io/tools/json-shaper/
- **Repository:** https://github.com/tidybytetools/json-shaper-lite
- **MCP Registry name:** io.github.tidybytetools/json-shaper-lite
- **Categories:** files and documents, developer tools
- **Listing updated:** 2026-11-14

## About

The same input always produces the same output, because the tool is plain code with no AI in the loop. It infers types, so a table row with 9.50 and false comes out as a number and a boolean, with column names turned into snake_case keys such as in_stock.

It installs from PyPI with pip or pipx, or you can download the single json_shaper_lite.py file, which relies only on Python's standard library. It works on Windows, Mac and Linux with Python 3.10 or newer, and the same package includes a small MCP server for Cursor, Claude Desktop and other clients, with no API key.

The lite version produces flat JSON and does not flatten nested JSON in the other direction. A paid Gumroad version, from $5 on a pay-what-you-want basis, adds app log parsing and a US address splitter.

## Features

- **Messy notes to JSON:** Reads pasted key: value lists into objects.
- **CSV, TSV and tables:** Converts CSV, TSV and Markdown tables to arrays of typed records.
- **Deterministic:** Plain code, so identical input gives identical JSON.
- **Runs locally:** Files stay on your computer; no upload or key needed.
- **CLI and MCP:** Use it from the command line or as an MCP server.
- **Single-file option:** json_shaper_lite.py runs on the standard library alone.

## Good for

- Convert a pasted Markdown table to JSON for an API call
- Turn meeting notes written as key: value lines into a record
- Clean a CSV export before loading it
- Give an assistant a deterministic converter instead of asking it to reformat data

## Install

### Claude Code (Terminal)

```sh
claude mcp add json-shaper-lite -- uvx json-shaper-lite
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "json-shaper-lite": {
      "command": "uvx",
      "args": [
        "json-shaper-lite"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "json-shaper-lite": {
      "command": "uvx",
      "args": [
        "json-shaper-lite"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "json-shaper-lite": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "json-shaper-lite"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "json-shaper-lite": {
      "command": "uvx",
      "args": [
        "json-shaper-lite"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "json-shaper-lite": {
      "command": "uvx",
      "args": [
        "json-shaper-lite"
      ]
    }
  }
}
```

## FAQ

### Does it use AI?

No. The README stresses plain code, so the same text always gives the same JSON.

### Does it upload my files?

No. It runs on your computer.

### What does the paid version add?

App log parsing and a one-line US address splitter, from $5 on Gumroad.

### Can it flatten nested JSON?

No. The free tool makes flat JSON only.

### Is json-shaper-lite free?

Yes. json-shaper-lite is open source, so you can use and self-host it for free.

### How do I add json-shaper-lite to Claude Code?

Run this command in your terminal: claude mcp add json-shaper-lite -- uvx json-shaper-lite

### What are the best alternatives to json-shaper-lite?

The closest alternatives to json-shaper-lite are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/json-shaper-lite
