json-shaper-lite

Free tool that turns key: value notes, CSV/TSV and Markdown tables into clean JSON. Need app logs or US addresses parsed too? The paid version does that: json-shaper on Gumroad

Plain code, not AI, so the same text always gives the same JSON. Runs on your own computer. MIT license. Works with Python 3.10 and newer, on Windows, Mac and Linux.

Also searched as: ES: convertir CSV a JSON, notas a JSON / PT: converter CSV para JSON / DE: CSV in JSON umwandeln / FR: convertir un CSV en JSON / JA: CSVをJSONに変換

Links

• Website — product page with prices and options
• Pro version on Gumroad — app logs and US address parsing

Before and after

Before (a small table or key: value notes):

name: Ada
city: London

After:

{"name": "Ada", "city": "London"}

CSV, TSV, and Markdown tables work the same way. This free tool makes flat JSON; it does not flatten nested JSON the other direction.

Install

pip install json-shaper-lite

Or use pipx, which keeps it in its own space:

pipx install json-shaper-lite

Want the newest code from GitHub instead?

pip install git+https://github.com/tidybytetools/json-shaper-lite

Or just download json_shaper_lite.py and run it with python3. That one file uses only Python's standard library. (Installing with pip also adds the mcp package, which the MCP server needs.)

Use it

printf 'Name: Ada\nAge: 36\nActive: yes' | json-shaper-lite
json-shaper-lite export.csv
json-shaper-lite notes.md --format markdown
json-shaper-lite export.csv --json      # {"ok": true, "format": "csv", "data": [...]}

Output:

{"name": "Ada", "age": 36, "active": true}

Numbers come out as numbers, yes/no and true/false as booleans, and empty or "null" as null. The format is detected for you, or you can set it with --format kv|csv|markdown.

From Python:

from json_shaper_lite import shape
shape("x,y\n1,2")  # {'format': 'csv', 'data': [{'x': 1, 'y': 2}]}

When you run it in a terminal it prints one short line about the paid version to stderr after the result. It never goes into your JSON output, it only shows when you are looking at a terminal, and --quiet turns it off.

Known limits

• It makes flat JSON. It does not flatten or unflatten nested JSON. For that, use a tool like flatten-json.
• Types are a best guess. A value like 007 or a zip code can turn into a number. Fix those by hand after.
• One table per run. Two Markdown tables in one file get mixed together. Split them first.
• Ragged rows. A CSV or Markdown row with more fields than the header is an error (exit 1). A short row keeps every header key and fills the missing ones wit

... View full README on GitHub