Connect SimplyPrint to any AI assistant via MCP
Connect SimplyPrint to any AI assistant via MCP
SimplyPrint ships an official MCP server, which means any AI assistant that speaks MCP (Model Context Protocol) can plug straight into your account. Ask Claude, ChatGPT, Gemini, Cursor or any other MCP-aware assistant to pause a print, approve pending queue items, mark a spool as freshly dried, or check this week's success rate - things you'd normally click in the panel, now spoken in plain English.
Listed on the official MCP Registry
SimplyPrint is published on the official Model Context Protocol registry as io.simplyprint/simplyprint. Some AI clients can discover SimplyPrint by browsing their built-in MCP server directory, so if your client offers an "add MCP server" search, try searching for "simplyprint" before pasting anything.
If your client does not yet support registry browsing, the URL below works in every MCP-aware client either way.
The MCP URL
One URL works in every MCP client:
https://simplyprint.io/api/mcp
Paste it into your assistant's connector settings and approve the OAuth consent screen. That's the whole integration.
What you can ask your assistant
Once connected, your assistant can do (almost) anything you can do in the SimplyPrint panel. A few examples:
Printers
- "What's printing right now?"
- "Pause the print on the Bambu P1S."
- "Home all three axes on Printer 4."
- "Send M104 S210 to the Prusa to preheat the nozzle."
Print queue
- "Move all PETG jobs to the bottom of the queue."
- "Approve the three pending items from Sarah."
- "Queue five copies of benchy.gcode for tomorrow."
- "Which printer in the shop can print the next item fastest?"
Files
- "Find every file tagged 'prototype' and delete them."
- "Estimate the cost of printing battery-holder.gcode on the X1C."
- "Move all STLs in 'sandbox' into the 'archive' folder."
Filament
- "Which spools are below 100 grams?"
- "Mark the orange PLA as freshly dried."
- "Adjust the remaining weight on spool 42 to 820 grams."
Stats and history
- "What was our print success rate last month?"
- "How much filament did we use this week?"
- "Show me the details of yesterday's longest print."
How the connection works
The connection uses OAuth - the same secure login flow you use for signing into apps with Google or GitHub. You never paste an API key into a chatbot, and you can revoke access any time.
Here's what happens under the hood:
- You paste the SimplyPrint MCP URL into your AI assistant's integrations or connector settings.
- The assistant opens a SimplyPrint login page.
- You log in and approve a list of permissions (called "scopes") - read printers, manage the queue, and so on.
- The assistant gets a token tied to your account with exactly the permissions you approved. Nothing more.
- You're connected. Ask your assistant whatever you want.
Supported AI assistants
Every client sets up its custom connector slightly differently. We have a dedicated guide for Claude below; for other clients, follow your client's own "add MCP server" or "custom connector" docs and point it at the URL above. The connection itself is identical in every case.
Claude (claude.ai, Claude Desktop, Claude Code)
Anthropic's Claude works in three places - the web app at claude.ai, the Claude Desktop app, and the Claude Code terminal assistant. The setup for each is covered in Connect SimplyPrint to Claude.
ChatGPT
ChatGPT supports MCP via its custom connectors feature. In ChatGPT, open a new chat, click the connector icon, and add a custom connector pointing at https://simplyprint.io/api/mcp.
Google Gemini CLI
Install the official SimplyPrint extension: gemini extensions install SimplyPrint/simplyprint-gemini-extension. Or point any MCP-capable Gemini surface at https://simplyprint.io/api/mcp directly if you would rather skip the extension wrapper. Full walkthrough: Connect SimplyPrint to Gemini CLI.
Cursor, Windsurf, Cline, Zed and other editors
Any editor or tool that supports remote MCP servers can connect. Look for "MCP servers" or "custom connectors" in its settings, add a new one, and paste the URL above. The OAuth flow opens in your default browser.
Self-hosted chat frontends
Any tool that implements the MCP client spec (including open-source chat frontends and agent frameworks) can connect. Consult your client's docs for how to add a custom MCP server, then use the same URL.
What the assistant can and cannot do
Each permission (scope) grants the assistant a specific slice of your account. Only grant what the assistant actually needs.
Permission | What it lets the assistant do |
|---|---|
View your printers' details | See printer names, status, current print, bed temperature, etc. |
Operate your printers | Pause, resume, cancel, home, send G-code |
View your print queue | List queue items, view details, see pending approvals |
Manage your print queue | Add items, reorder, edit, delete, approve, deny, comment |
View your files and folders | List files, search by name, estimate costs |
Manage your files and folders | Move, rename, delete, create folders, set printer assignments |
View filament spools | See remaining weight, assignments, drying status |
Manage filament spools | Adjust weight, assign to printers, mark dried |
View your print history | See past jobs, success/failure, filament used |
Manage your print history (archive, restore) | Archive and unarchive jobs |
View your print statistics | Success rate, filament totals, cost summaries |
View your custom fields | List field definitions (deadline, order number, etc.) |
Manage your custom fields and their values | Set values across queue items (sort by deadline, etc.) |
View your slicer profiles | Look up which slicer settings were used on a file |
Security and revoking access
OAuth is safer than pasting an API key, because:
- The token is scoped to exactly the permissions you approved.
- The token is bound to your user - not to your account admin or anyone else.
- You can revoke access at any time and the assistant instantly stops working.
To revoke, go to Account settings > Connected apps. You'll see every connected assistant, the scopes it was granted, and when it last made a request. Click Revoke to disconnect.
Frequently asked questions
Does my data train the AI?
No. Data you send through your assistant goes to the assistant's servers (Anthropic, OpenAI, etc.) per their own data policies. It does not train SimplyPrint's systems. Check your assistant's own privacy settings if you're concerned.
Can the assistant start a print without asking me?
It depends on which scopes you granted. If you granted "Operate your printers", yes, it can - but most assistants will still confirm destructive actions with you first. For extra safety, skip the "Manage" scopes and only grant "View" scopes if you want a read-only connection.
What does it cost?
Using the MCP is free and included in your SimplyPrint plan. API calls from the assistant count against your normal usage.
Can multiple assistants connect at once?
Yes. Each one gets its own token with its own scopes, and you can revoke any of them independently.
What if a new tool is added?
New tools are added periodically as SimplyPrint gains features. Your connected assistants pick them up automatically the next time they refresh the tool list - no re-connecting needed.
Does this work with the mobile app?
The MCP is a server-side integration, so it doesn't depend on the mobile app. As long as your SimplyPrint account is active, any MCP client on any device can connect.
My assistant isn't listed above - will it work?
If it says it supports MCP (sometimes called "custom connectors" or "tool servers"), yes. The URL is the same. If you hit snags, send us the assistant's name and any error message and we'll take a look.
Related articles
- Connect SimplyPrint to Claude (claude.ai and Claude Code)
- Connect SimplyPrint to Gemini CLI
- The print queue
- Using custom fields
- Integrating user balances via the API
- SimplyPrint API documentation
Updated on: 22/04/2026
Thank you!