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

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

Related MCP server: teaching-mcp-server

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.