Skip to content
snowkitDocs

Snowkit for AI apps

A small, open-source program that lets AI apps use Snowkit tools on your own computer. Your files never leave it.

What it is

Snowkit for AI apps is a small, open-source program that lets AI apps use Snowkit tools on your own computer. Ask your assistant to merge two PDFs, make a QR code or tidy some JSON, and it does the job with Snowkit, right where your files are.

Your files never leave your computer. The program has no account, never connects to the internet and keeps no copies. It works with any app that supports the Model Context Protocol (MCP), and from the command line too.

What you need

Node.js 18 or newer. There is nothing else to install: the setups below fetch Snowkit from npm 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 this instead:

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

Claude Code

Run this once in your terminal:

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 that talks over standard input and output. Point your app at this 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?

The tools

Snowkit for AI apps has 14 tools. Each result ends with a link to the matching tool on snowkit.io, in case you would rather see it in your browser.

ToolWhat it does
pdf_mergeCombines two or more PDFs into one, in the order you give.
pdf_splitSplits a PDF into one file per page, every few pages, or by page ranges.
pdf_extract_pagesCopies chosen pages into a new PDF, which also reorders or drops pages.
pdf_rotateTurns all or some pages by 90, 180 or 270 degrees.
pdf_infoShows page count, page sizes, PDF version, form fields and document details.
markdown_to_pdfTurns Markdown into a clean, paginated PDF.
qr_codeMakes a QR code for a link or any text, as SVG or PNG.
json_formatPretty-prints or minifies JSON, keeping large numbers exact.
json_validateChecks JSON, and optionally checks it against a JSON Schema.
sql_formatFormats or minifies SQL.
text_statsCounts words, characters and sentences, with reading time and readability.
text_transformChanges case, makes URL slugs, or removes duplicate lines.
color_convertConverts a colour between hex, RGB, HSL, HSV and OKLCH, and checks contrast.
cron_explainExplains a cron schedule in plain English and lists the next runs.

Command line

The same tools work 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 qr "https://example.com" -o qr.png npx snowkit json format data.json --sort 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. Install it once and you can drop the npx:

npm install -g snowkit

How it treats your files

  • It only reads the files you name, and writes where you ask, or next to the original when you do not say.
  • It never replaces an existing file unless you ask it to, with overwrite or --overwrite.
  • 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

Snowkit for AI apps is free and open source under the MIT licence. It is published on npm as snowkit, and the code is on GitHub.

Something unclear? Tell us and we will improve this page.