Snowkit

Snowkit

Private tools that run on your computer.

Snowkit merges and splits PDFs, makes QR codes, tidies JSON and SQL, counts words and more. It works from the command line, and it plugs into AI apps that support the Model Context Protocol (MCP), so your assistant can do real work on your files.

Your files never leave your computer. Snowkit has no account, sends nothing over the internet and keeps no copies. It reads the files you point it to and writes the results next to them.

What it can do

Tool	What it does
pdf_merge	Combines two or more PDFs into one, in the order you give
pdf_split	Splits a PDF into one file per page, every few pages, or by page ranges
pdf_extract_pages	Copies chosen pages into a new PDF, which also reorders or drops pages
pdf_rotate	Turns all or some pages by 90, 180 or 270 degrees
pdf_info	Shows page count, page sizes, PDF version, form fields and document details
markdown_to_pdf	Turns Markdown into a clean, paginated PDF
qr_code	Makes a QR code for a link or any text, as SVG or PNG
json_format	Pretty-prints or minifies JSON, keeping large numbers exact
json_validate	Checks JSON, and optionally checks it against a JSON Schema
sql_format	Formats or minifies SQL
text_stats	Counts words, characters and sentences, with reading time and readability
text_transform	Changes case, makes URL slugs, or removes duplicate lines
color_convert	Converts a colour between hex, RGB, HSL, HSV and OKLCH, and checks contrast
cron_explain	Explains a cron schedule in plain English and lists the next runs
image_info	Shows what a JPEG, PNG or WebP photo reveals: camera, date and the location it was taken
image_strip_metadata	Removes the hidden location, camera details and comments from a photo, leaving the picture as it was
head_tags	Writes the title, description, canonical, Open Graph and Twitter tags for a page
head_check	Checks a page's HTML for missing or too-long head tags and says what to fix

Each result ends with a link to the matching tool on snowkit.io, in case you would rather see it in your browser.

Use it with your AI app

You need Node.js 18 or newer. There is nothing else to install: the commands below fetch Snowkit the first time it runs.

Claude Desktop

Open Settings, then Developer, then Edit Config, and add Snowkit to claude_desktop_config.json:

{
  "mcpServers": {
    "snowkit": {
      "command": "npx",
      "args": ["-y", "snowkit"]
    }
  }
}

Restart Claude Desktop. If it cannot find npx on Windows, use "command": "cmd" and "args": ["/c", "npx", "-y", "snowkit"].

Claude Code

claude mcp add snowkit -- npx -y snowkit

Cursor

Open Cursor Settings, then MCP, then Add new MCP server, or add this to ~/.cursor/mcp.json (or .cursor/mcp.json inside a project):

{
  "mcpServers": {
    "snowkit": {
      "command": "npx",
      "args": ["-y", "snowkit"]
    }
  }
}

Gemini CLI

Add this to ~/.gemini/settings.json:

{
  "mcpServers": {
    "snowkit": {
      "command": "npx",
      "args": ["-y", "snowkit"]
    }
  }
}

Any other MCP app

Snowkit is a standard MCP server over standard input and output. Point your app at the command npx -y snowkit.

Then just ask, for example:

• "Merge invoice-march.pdf and invoice-april.pdf in my Downloads folder."
• "Pull pages 3 to 5 out of contract.pdf."
• "Make a QR code PNG for https://example.com and save it to my desktop."
• "Is this JSON valid?"

Use it from the command line

npx snowkit pdf merge a.pdf b.pdf -o both.pdf
npx snowkit pdf split report.pdf --every 2
npx snowkit pdf split report.pdf --range 1-3 --range 4-
npx snowkit pdf extract report.pdf --pages "1, 4-6"
npx snowkit pdf rotate scan.pdf --angle 90 --pages 2
npx snowkit pdf info report.pdf
npx snowkit md2pdf notes.md --page letter --numbers
npx snowkit qr "https://example.com" -o qr.png
npx snowkit json format data.json --sort
npx snowkit json validate data.json --schema schema.json
npx snowkit sql format query.sql
npx snowkit text stats essay.txt
npx snowkit text case title headings.txt
npx snowkit text dedupe emails.txt --ignore-case
npx snowkit color "#336699" --against white
npx snowkit cron "*/15 9-17 * * 1-5"
npx snowkit --help

Text commands read the file you name, or standard input when you pipe text in, so they fit into scripts:

curl -s https://api.example.com/items | npx snowkit json format

Install it once with npm install -g snowkit and you can drop the npx.

How it treats your files

• It only reads the files you name and only writes where you ask, or next to the original when you do not say.
• It never replaces an existing file unless you set overwrite (or pass --overwrite on the command line).
• It never connects to the internet. Every tool runs on your own computer.
• Password-protected PDFs are left alone, with a clear message.

Good to know

• markdown_to_pdf uses built-in fonts that cover Western European languages. Images in the Markdown are left out.
• pdf_rotate keeps everything else in the file as it was. Merging, splitting and extracting copy the pages themselves, so bookmarks and document details from the originals are not carried over.
• Errors explain what went wrong and how to fix it, so your assistant can try again sensibly.

Licence

MIT. See LICENSE.