How to integrate Printful MCP with Hermes

Connect Hermes 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

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Printful account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

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

Also integrate Printful with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,700+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Printful with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Printful

Ask your agent to connect to Printful, or simply request any Printful-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Printful connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Printful or request any Printful-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Printful MCP server, 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.

Way Forward

With Printful connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

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