PrintGo MCP server

PrintGo-MCP

PrintGo lets an AI assistant print to the printers on your computer. It's an MCP server: once your MCP client is connected to it, the assistant can list your printers, send them PDFs, images, text, Markdown, or HTML, and check on the jobs afterwards.

PrintGo runs on the computer the printer is connected to and puts itself behind a Cloudflare tunnel, so your assistant can reach it from anywhere: a cloud agent, another laptop, or the same machine.

What you need

about. PrintGo doesn't install drivers; it talks to the print system you already have:

• Node.js 22.12 or newer.
• macOS, Linux, or Windows, with a printer your operating system already knows

commands).

• macOS and Linux use CUPS (the lp, lpstat, lpoptions, and cancel

PrintGo turns everything into a PDF before printing, so SumatraPDF is needed for every job, not just PDFs. It should be on your PATH, or you can point to it with --sumatra-pdf .

• Windows uses PowerShell and SumatraPDF.

don't have either, printgo install-browser will download one. To use a specific browser, pass --chrome or set PRINTGOCHROMEPATH.

• Chrome or Chromium, but only if you want to print Markdown or HTML. If you

Getting started

Install the CLI:

npm install -g printgo

Then start it:

printgo start

This starts PrintGo in the background along with a Cloudflare tunnel, then prints an MCP URL and a password. Add that URL to your MCP client and send the password as an Authorization: Bearer header. Your client needs to support MCP's Streamable HTTP transport; the older SSE transport isn't supported.

The password is generated the first time you run start and reused after that. Treat it like a key to your printer: anyone who has it can print, and can cancel jobs PrintGo has submitted. Traffic goes through Cloudflare.

PrintGo needs cloudflared for the tunnel. If it can't find one, it asks before downloading the official release from GitHub. Pass --yes to skip the question (you'll need this when there's no terminal to answer it), or --no-download to fail instead. If cloudflared lives somewhere unusual, pass --cloudflared .

If you'd rather not install globally, npx printgo works too. The package also installs a printgo-mcp command, which is the same thing under another name.

Managing the server

printgo status
printgo stop
printgo restart

restart reuses the settings from your last start. If something goes wrong, the background server's log is at ~/.printgo/daemon.log.

By default you get a Cloudflare Quick Tunnel, which needs no Cloudflare account, but its URL changes every time PrintGo starts. If you have a domain on Cloudflare, you can give PrintGo a stable address instead:

printgo stop
printgo start --custom-domain-with-cf printer.example.com

If cloudflared isn't logged in to your Cloudflare account yet, this opens a browser so you can log in. PrintGo then creates a tunnel in your account (or reuses one it made before) and adds a DNS record for that hostname. It won't overwrite a DNS record that already exists.

Custom domain settings are saved, so later start and restart calls reuse them. Pass --quick to use a Quick Tunnel for a particular run. You can also connect a tunnel you already have, or use a token from the Cloudflare dashboard; printgo start --help lists all the options. Add --json to start, stop, status, or restart if you're calling them from a script.

Local only, without a tunnel

If your MCP client runs on the same computer as the printer, you can skip the tunnel and let the client launch PrintGo directly over stdio:

{
  "mcpServers": {
    "printgo": {
      "command": "printgo",
      "args": ["stdio"]
    }
  }
}

Shortened. The full README is on GitHub.