How to connect Printful to Claude

Connect Claude Web, Desktop and Cowork to Printful MCP. List your printful stores and product catalogs, check printful orders awaiting fulfillment today, and more using natural language, with authentication handled for you.

Printful logoPrintful
Oauth2Api Key

Printful is an on-demand printing and fulfillment platform for products, stores, and orders. It helps businesses sell custom goods without holding inventory or managing shipping.

107 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Printful account to Claude via Composio Connect, enabling it to list your Printful stores and product catalogs, check Printful orders awaiting fulfillment today, create mockups for your newest Printful products, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Printful with

Connecting Printful to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Printful account

Back in Claude, ask it to connect to Printful or give it any Printful-related task.

For example, ask Claude to:

  • "List your Printful stores and product catalogs"
  • "Check Printful orders awaiting fulfillment today"
  • "Create mockups for your newest Printful products"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Printful account is ready to use.

What is the Printful Claude Connector, and what's possible with it?

The Printful MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Printful account. It provides structured and secure access to your product catalog, stores, orders, files, mockups, shipping rates, and store settings, so your agent can create products, prepare and manage orders, estimate fulfillment costs, generate mockups, and review store information on your behalf.

  • Catalog and product research: Have your agent browse catalog categories and products, retrieve variant details and size guides, and check available print files before creating merchandise.
  • Store product management: Let the agent create, inspect, and remove store products and variants, or retrieve product templates for managing your Printful storefront.
  • Order and fulfillment workflows: Direct your agent to create draft orders, estimate item and fulfillment costs, calculate shipping rates, retrieve orders, cancel pending orders, or submit drafts for fulfillment.
  • Files and mockup generation: Instruct your agent to add design files from public URLs, inspect file details, create mockup tasks, check their results, and retrieve mockup templates.
  • Store operations and settings: Have your agent review store details and statistics, inspect webhook settings, disable webhook configurations, list approval sheets, or approve designs for held orders.

Troubleshooting

1. Why does Claude not use the Composio connector for Printful?

The connector can show as connected, but Claude must use it in each Printful conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Printful again.

2. Why does Claude show an MCP server error before Printful connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Printful.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Printful.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Printful authorization link not work?

The Composio connector is one server. Your Printful account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Printful connection.
  • Composio creates a fresh Printful authorization link.
  • Open that link in your browser and finish the Printful sign-in.

4. Why do Printful actions fail after they worked before?

The Printful connection can expire or lose permission.

  • Ask Claude to inspect the Printful connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Printful account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Printful.
  • If the action still fails with a permission error, check that the connected account has that permission in Printful itself.

5. How do I switch to a different Printful account?

Claude can manage the Printful connection for you.

  • Ask Claude to disconnect or delete the current Printful account.
  • Ask Claude to connect Printful again.
  • Open the new Composio authorization link for Printful.
  • Sign in with the other Printful account in the browser.
  • After the account connects, ask Claude to retry the Printful task.

6. Why is my Printful connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Printful connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Printful tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Printful.
TOOLS

Supported Tools

Every Printful action and event your agent gets out of the box.

V1 Add File

Add a file to the Printful v1 file library from a public URL.

V1 Approve Design

Approves a design using its approval-sheet confirm hash and removes the order hold.

V1 Calculate Shipping Rates

Calculate Printful v1 shipping methods and rates for a recipient and products.

V1 Cancel Order

Cancel a pending or draft Printful v1 order and return charged funds when applicable.

V1 Confirm Order

Irreversibly submit a Printful v1 draft order for fulfillment; this may incur charges.

V1 Create Mockup Task

Creates an asynchronous Printful v1 mockup generation task.

V1 Create Order

Create a Printful v1 order as a draft or immediately submit it for fulfillment.

V1 Create Store Product

Create a Printful v1 store sync product together with its configured variants and print files.

V1 Create Store Variant

Create a Printful v1 sync variant under an existing store sync product.

V1 Delete Ecommerce Sync Product

Delete a Printful v1 sync product and all of its sync variants.

V1 Delete Ecommerce Sync Variant

Delete configuration and disable automatic importing for a Printful v1 sync variant.

V1 Delete Product Template

Permanently delete an account-level Printful v1 product template.

V1 Delete Store Product

Permanently delete a Printful v1 store sync product and its variants.

V1 Delete Store Variant

Permanently delete a Printful v1 store sync variant.

V1 Disable Webhook Configuration

Removes the webhook URL and all enabled event types from the authorized Printful store.

V1 Estimate Order Costs

Estimate Printful v1 item, print, shipping, and tax costs without creating an order.

V1 Get Catalog Category

Get one Printful v1 catalog category by category ID.

V1 Get Catalog Product

Get a Printful v1 catalog product and all of its variants by product ID.

V1 Get Catalog Product Size Guide

Get the Printful v1 size guide for a catalog product in selected units.

V1 Get Catalog Variant

Get a Printful v1 catalog variant and its parent product by variant ID.

V1 Get Ecommerce Sync Product

Get a Printful v1 sync product and its sync variants.

V1 Get Ecommerce Sync Variant

Get one Printful v1 ecommerce sync variant.

V1 Get File

Return information about a Printful v1 file-library file.

V1 Get Mockup Task

Returns the state and generated output of a Printful v1 mockup task.

V1 Get Mockup Templates

Retrieves Printful v1 templates for client-side mockup positioning.

V1 Get Order

Get a Printful v1 order by its Printful or external ID.

V1 Get Product Printfiles

Lists Printful v1 printfiles available for a product's variants.

V1 Get Product Template

Get an account-level Printful v1 product template by internal or external product ID.

V1 Get Store

Gets basic information about a Printful store by ID.

V1 Get Store Product

Get a Printful v1 store sync product and its variants by internal or external ID.

V1 Get Store Statistics

Returns Printful store statistics for selected report types and date range.

V1 Get Store Variant

Get a Printful v1 store sync variant by internal or external ID.

V1 Get Warehouse Product

Returns a Printful warehouse product by ID.

V1 Get Webhook Configuration

Returns the webhook URL and enabled event types for the authorized Printful store.

V1 List Approval Sheets

Lists approval sheets for suggested changes to files on held Printful orders.

V1 List Catalog Categories

List the hierarchy of Printful v1 catalog categories.

V1 List Catalog Products

List all Printful v1 catalog products, optionally filtered by category IDs.

V1 List Countries

Return the Printful v1 list of accepted countries and states.

V1 List Ecommerce Sync Products

Return one page of Printful v1 ecommerce sync products.

V1 List OAuth Scopes

List permission names associated with the connected Printful token without returning the token itself.

V1 List Orders

Return one page of orders from the connected Printful v1 store.

V1 List Product Templates

Return one page of account-level Printful v1 product templates.

V1 List Store Products

Return one page of Printful v1 store sync products with status and category filters.

V1 List Stores

Gets basic information about stores available to the connected Printful credential.

V1 List Tax Countries

Return the Printful v1 countries and states that require sales-tax calculation.

V1 List Warehouse Products

Returns warehouse products from the authorized Printful store.

V1 Set Webhook Configuration

Enables or replaces the webhook URL and event types for the authorized Printful store.

V1 Submit Approval Sheet Bulk Changes

Submits alternative changes in bulk for approval sheets sharing a design group hash.

V1 Submit Approval Sheet Changes

Submits alternative changes for a design with a Printful approval sheet.

V1 Suggest Thread Colors

Suggest Printful embroidery thread colors that closely match an image.

V1 Update Ecommerce Sync Variant

Update writable fields of a Printful v1 ecommerce sync variant.

V1 Update Order

Update a Printful v1 unsubmitted order and optionally submit it for fulfillment.

V1 Update Store Packing Slip

Modifies packing slip information of the currently authorized Printful store using the v1 API.

V1 Update Store Product

Update writable fields of a Printful v1 store sync product and optionally replace its retained variant set.

V1 Update Store Variant

Update writable fields of a Printful v1 store sync variant.

V2 Add File

Add a URL-hosted file to the Printful v2 file library, or return the existing file for an identical URL.

V2 Calculate Shipping Rates

Calculate Printful v2 shipping services, prices, and delivery estimates for up to 100 typed items.

V2 Confirm Order

Irreversibly submit a Printful v2 draft order for fulfillment; this may incur charges.

V2 Create Mockup Tasks

Create one or more asynchronous Printful v2 mockup-generation tasks.

V2 Create Order

Create a Printful v2 draft order with fully typed recipient, item, design, customization, and retail-cost data.

V2 Create Order Estimation Task

Create an asynchronous Printful v2 cost-estimation task for typed catalog or product-template items.

V2 Create Order Item

Add a typed catalog or product-template item to an existing Printful v2 order.

V2 Delete Order

Permanently delete an eligible draft, failed, or cancelled Printful v2 order.

V2 Delete Order Item

Remove one item from a Printful v2 order.

V2 Disable Webhook Configuration

Remove the Printful v2 webhook URL and all enabled event types.

V2 Disable Webhook Event

Disable one Printful v2 webhook event while preserving other event settings.

V2 Download Approval Sheet PDF

Download a Printful v2 approval sheet as a PDF file.

V2 Get Catalog Category

Get one Printful v2 catalog category by ID.

V2 Get Catalog Product

Get one Printful v2 catalog product by ID.

V2 Get Catalog Product Availability

Get paginated v2 stock availability for a Printful catalog product.

V2 Get Catalog Product Prices

Get paginated v2 pricing for a Printful catalog product and its variants.

V2 Get Catalog Product Size Guide

Get the v2 size guide for a Printful catalog product.

V2 Get Catalog Variant

Get one Printful v2 catalog variant by ID.

V2 Get Catalog Variant Availability

Get v2 stock availability for one Printful catalog variant.

V2 Get Catalog Variant Prices

Get v2 pricing for one Printful catalog variant and its parent product.

V2 Get File

Retrieve metadata and processing status for a Printful v2 file-library entry.

V2 Get Order

Retrieve one Printful v2 order by its Printful or external ID.

V2 Get Order Estimation Task

Retrieve a Printful v2 order cost estimation task; completed results remain available for one hour.

V2 Get Order Invoice

Retrieve a Printful v2 order invoice as base64-encoded PDF content.

V2 Get Order Item

Retrieve one fully detailed item from a Printful v2 order.

V2 Get Store

Retrieve one Printful v2 store by its resource ID.

V2 Get Store Statistics

Retrieve selected Printful v2 statistics for one store over a period of at most six months.

V2 Get Warehouse Product

Retrieve one Printful v2 warehouse product with its variants and stock locations.

V2 Get Webhook Configuration

Return the Printful v2 webhook configuration for the connected store.

V2 Get Webhook Event Configuration

Return one Printful v2 webhook event configuration.

V2 List Approval Sheets

Return one page of Printful v2 approval sheets awaiting or recording design review.

V2 List Catalog Categories

List categories in Printful's v2 catalog.

V2 List Catalog Product Categories

List the v2 catalog categories associated with a Printful product.

V2 List Catalog Product Images

List and filter blank images for a Printful v2 catalog product.

V2 List Catalog Product Mockup Styles

List available mockup styles for a Printful v2 catalog product.

V2 List Catalog Product Mockup Templates

List positional mockup template data for a Printful v2 catalog product.

V2 List Catalog Products

List and filter products in Printful's v2 catalog.

V2 List Catalog Product Shipping Countries

List countries to which a Printful v2 catalog product can be shipped.

V2 List Catalog Product Variants

List one page of v2 catalog variants belonging to a Printful product.

V2 List Catalog Variant Images

List and filter images for a Printful v2 catalog variant.

V2 List Countries

List countries and states where Printful is available using the v2 API.

V2 List Mockup Tasks

Return one page of asynchronous Printful v2 mockup tasks and their current results.

V2 List OAuth Scopes

List permission names associated with the connected Printful token using the v2 API without returning the token itself.

V2 List Order Items

Retrieve one page of items belonging to a Printful v2 order.

V2 List Orders

Retrieve one page of Printful v2 orders from the connected store.

V2 List Order Shipments

Retrieve one page of fulfillment shipments for a Printful v2 order.

V2 List Stores

Return one page of Printful v2 stores available to the connected credential.

V2 List Warehouse Products

Return one page of detailed Printful v2 warehouse products and variants.

V2 Set Webhook Configuration

Create or replace the Printful v2 webhook configuration for the connected store.

V2 Set Webhook Event Configuration

Create or replace one Printful v2 webhook event configuration.

V2 Update Order

Partially update writable fields of a Printful v2 order; omitted fields remain unchanged.

V2 Update Order Item

Update a Printful v2 catalog or product-template order item without changing its source.

FAQ

Frequently asked questions

Start with Printful.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Printful tool your agent needs.Free to start.

Start building