json-shaper-lite
Turn key: value notes, CSV/TSV and Markdown tables into typed JSON, offline
- Pricing
- Open source
- Platforms
- CLI, Windows, macOS
- Runs
- Locally
- Version
- 1.1.2
- Listing updated
- 3 days ago
About json-shaper-lite
json-shaper-lite is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add json-shaper-lite -- uvx json-shaper-liteAdd to claude_desktop_config.json
{
"mcpServers": {
"json-shaper-lite": {
"command": "uvx",
"args": [
"json-shaper-lite"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"json-shaper-lite": {
"command": "uvx",
"args": [
"json-shaper-lite"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"json-shaper-lite": {
"type": "stdio",
"command": "uvx",
"args": [
"json-shaper-lite"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"json-shaper-lite": {
"command": "uvx",
"args": [
"json-shaper-lite"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"json-shaper-lite": {
"command": "uvx",
"args": [
"json-shaper-lite"
]
}
}
}What it does
- 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
Pricing
Open source, from $5 a month
Free lite tool is MIT-licensed; paid version from $5 (pay what you want) on Gumroad
Prices change. Check tidybytetools.github.io before you buy.
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 to json-shaper-lite

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools