PrintPal For the Gemini app and Gemini CLI · Free

PrintPal for Gemini: 3D printing tools in Gemini and the Gemini CLI

Add PrintPal's MCP server to Gemini and ask about models, filament, print costs and failed prints in plain language. The same URL works in the Gemini CLI and in agents you build with Google's ADK.

  • Free
  • No sign-in for search and calculators
  • Gemini app & CLI
  • Works with Google ADK
Overview

What is PrintPal for Gemini?

PrintPal for Gemini connects Google Gemini to PrintPal, a 3D printing platform, through a free remote MCP server at https://printpal.io/mcp. With it, Gemini can search printable 3D models, run print-cost, filament, layer-height and volumetric-flow calculators, answer troubleshooting questions with citations from PrintPal's wiki, and find Arduino and ESP32 build guides.

It works as a custom app in the Gemini app, as an MCP server in the open-source Gemini CLI, and as an MCPToolset in agents built with Google's Agent Development Kit.

Updated October 27, 2026 · Made by PrintPal

At a glance

Works in
Gemini app (custom apps), Gemini CLI, Google ADK agents
Price
Free. AI 3D generation uses PrintPal credits and is optional.
Account needed
Only for AI 3D generation (API key in the Gemini CLI)
Server URL
https://printpal.io/mcp
Transport
Streamable HTTP
Tools
18
Features

What PrintPal for Gemini can do

Model search

Find printable STL, 3MF and OBJ models from the PrintPal community library with author and license.

Filament and cost math

Grams to metres, spool remaining, cost per print and a suggested selling price.

Cited fixes

Warping, stringing, under-extrusion and error codes, answered from the full PrintPal wiki article with a link.

Gemini CLI ready

One gemini mcp add command, or a few lines in settings.json, and the tools are available in every session.

Build your own agent

Point an ADK MCPToolset at the server to give your own Gemini agent 3D printing skills.

Design hand-off

Gemini drafts a CAD brief for PrintPal's AI CAD agent or opens the AI 3D generator with your prompt.

Install

How to add PrintPal to Gemini

  1. In the Gemini app, open Settings → Connected apps → Custom apps and choose Add.
  2. Paste https://printpal.io/mcp as the server URL. No authentication is needed for search, calculators, the wiki and build guides.
  3. In a chat, mention @PrintPal and ask your question.
  4. For the Gemini CLI, run the command below instead and restart the CLI.

Custom apps in the Gemini app roll out by plan and region. The Gemini CLI works everywhere.

Gemini CLI

Adds PrintPal to your Gemini CLI settings.

gemini mcp add --transport http printpal https://printpal.io/mcp
Gemini CLI settings.json

Or add it by hand to ~/.gemini/settings.json. Add a headers entry with Authorization: Bearer $PRINTPAL_API_KEY to enable direct AI generation.

{
  "mcpServers": {
    "printpal": {
      "httpUrl": "https://printpal.io/mcp",
      "timeout": 60000
    }
  }
}
Google Agent Development Kit (Python)

Give your own Gemini agent PrintPal's tools.

from google.adk.tools.mcp_tool.mcp_toolset import MCPToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams

printpal = MCPToolset(
    connection_params=StreamableHTTPConnectionParams(url="https://printpal.io/mcp")
)
Try it

Prompts to try in Gemini

@PrintPal find a printable cable organizer for my desk.
@PrintPal how much filament is left on a spool that weighs 612 g with a 210 g empty spool?
@PrintPal my ABS print is warping at the corners. What should I change?
@PrintPal show me a beginner ESP32 build guide with a printed case.
@PrintPal design a 3D-printable phone stand with a 15° tilt and a slot for a USB-C cable.

The 18 PrintPal tools

Every AI assistant integration exposes the same tools from the PrintPal MCP server. Fourteen work without an account. The generation and profile tools need a connected PrintPal account: sign-in with PrintPal in ChatGPT, or a PrintPal API key in clients where you can set a request header. Only generate_3d_model spends credits, and only with a cost quote from prepare_3d_generation that the assistant is instructed to confirm with you first.

ToolWhat it doesAccount?
search_3d_modelsFind free printable STL, 3MF and OBJ models in the PrintPal community library, with thumbnail, author, license and stats.No
get_3d_modelDetails, files, license and the page link for one free model.No
calculate_print_costMaterial, electricity, machine wear, labor and failure allowance, plus a suggested selling price.No
calculate_filament_usageFilament grams to metres to cost, and how much is left on a spool.No
calculate_layer_heightsZ-axis "magic number" layer heights for your printer's leadscrew and stepper.No
calculate_volumetric_flowCheck a print speed and layer height against your hotend's volumetric flow limit.No
search_learning_resourcesSearch the vendor-neutral 3D printing wiki, OpenSCAD and AI CAD docs, video tutorials and Academy courses.No
search_build_guidesFind Arduino / ESP32 + 3D-printed project guides by idea, difficulty, time and cost.No
get_build_guideBill of materials, downloadable files and every step of one build guide.No
open_cad_agent_linkLink that opens PrintPal's AI CAD agent with a design brief prefilled. Running the agent on printpal.io uses your credits.No
prepare_3d_generationCheck an AI text-to-3D or image-to-3D request and quote its exact credit cost. Starts nothing and charges nothing.Connected account
generate_3d_modelStart a quoted generation on your PrintPal credits. Retrying the same request never charges twice.Connected account
check_3d_generationProgress of a generation you started, with a fresh download link once it is finished.Connected account
get_printpal_profileShows which PrintPal account is connected (display name and username only).Connected account
open_3d_generator_linkOpens PrintPal's AI 3D generator on printpal.io with a prompt prefilled. Generates nothing by itself.No
find_3d_printing_toolRecommend the right free PrintPal browser tool or calculator for a task.No
searchSearch everything on PrintPal at once: models, tools, wiki, docs, videos, guides and courses.No
fetchRead any search result in full (for example a wiki article) so the assistant can quote and cite it.No
Who it's for

Who uses PrintPal for Gemini

Terminal-first makers

Ask the Gemini CLI for a print cost or a layer height without leaving your shell.

Agent builders

Add 3D printing knowledge to a support bot, a classroom assistant or a print-farm agent.

Quick answers on the go

Check a filament setting or a fix from your phone while you stand at the printer.

Privacy

Privacy and how it works

What PrintPal for Gemini sends, stores and never touches.

  • Search, calculator, wiki and build-guide tools work without an account, and those requests are not saved to a PrintPal account.
  • PrintPal only receives what the assistant sends to a tool: a search phrase, calculator numbers, a model id, or a generation prompt and attached image. It does not receive the rest of your conversation.
  • AI 3D generation needs a connected PrintPal account. In ChatGPT you sign in to PrintPal and approve access, and ChatGPT gets its own revocable token, never your password or API key. In other clients you can send a PrintPal API key in a request header. Never paste either into a chat.
  • Generation prompts, attached images, the generated models and their credit charges are saved to your PrintPal account history, like generations made on printpal.io, and are covered by the PrintPal privacy policy. To produce the model, the prompt or image is sent to the AI generation services PrintPal uses for the chosen quality.
  • You can see and disconnect linked assistants at any time under Connected apps; disconnecting stops their access immediately.
  • Links back to printpal.io carry a utm_source tag so we can see which assistant sent the visit; no identifier is attached.
FAQ

Frequently asked questions about PrintPal for Gemini

Can Gemini help with 3D printing?

Yes. With the PrintPal app connected, Gemini can search printable 3D models, calculate filament usage and print costs, find magic-number layer heights, check volumetric flow, and troubleshoot failed prints with citations from PrintPal's wiki.

How do I add an MCP server to the Gemini CLI?

Run gemini mcp add --transport http printpal https://printpal.io/mcp, or add an mcpServers entry with "httpUrl": "https://printpal.io/mcp" to ~/.gemini/settings.json, then restart the CLI.

Does PrintPal work in the Gemini app?

Where your Gemini plan supports custom apps, add https://printpal.io/mcp under Settings, Connected apps, Custom apps, then mention @PrintPal in a chat. Search, calculators, the wiki and build guides need no sign-in.

Can I use PrintPal tools in my own Gemini agent?

Yes. In Google's Agent Development Kit, create an MCPToolset with StreamableHTTPConnectionParams(url="https://printpal.io/mcp"). The same tools are also available as REST endpoints described at https://printpal.io/mcp/openapi.json.

Is it free?

Yes. All tools except direct AI 3D generation are free and anonymous. For generation Gemini can open printpal.io with your prompt prefilled, or, with your PrintPal API key in the Gemini CLI, quote the credit cost and run it on your credits.

What data does PrintPal receive from Gemini?

Only the tool inputs Gemini sends, like a search phrase, calculator numbers or a generation prompt. PrintPal does not see your conversation. Generations started with your API key are saved to your PrintPal account history under the PrintPal privacy policy.

Get PrintPal for Gemini

Use PrintPal as a custom app in Gemini, in the Gemini CLI, or in agents built with Google's Agent Development Kit. Free to install. See all integrations.