Shopify Orders and Fulfillment MCP server

The Shopify Orders and Fulfillment MCP server enables LLMs to interact with Shopify stores for order management and fulfillment operations through natural conversation. It provides tools to retrieve order information, search orders, manage fulfillment status, and handle order cancellations without requiring direct interaction with the Shopify Admin interface.

Uses

Use the Shopify Orders and Fulfillment MCP server when you plan to perform the following actions:

• Look up complete order details by order number, ID, or customer email
• Search for orders by customer email, status, or date range
• View unfulfilled orders in the fulfillment queue
• Mark orders as fulfilled with tracking information
• Cancel orders with optional refund and restock
• Add internal staff notes to orders for documentation

Example prompts

• Get the details for order #1234.
• Find all orders from [email protected].
• Show me orders that are paid but not yet shipped.
• What orders need to ship today?
• Mark order #5678 as fulfilled with tracking number 1Z999AA10123456789.
• Cancel order #9012 and refund the customer.
• Add a note to order #3456 about the customer's request.

Shopify Orders and Fulfillment MCP server tools

The Shopify Orders and Fulfillment MCP server provides the following tools:

Tool	Description
get_order	Retrieves complete details for a single order given an order identifier.
search_orders	Searches orders matching specified filter criteria.
list_unfulfilled_orders	Retrieves orders with unfulfilled or partially fulfilled status.
fulfill_order	Creates a fulfillment record for an order, marking items as shipped.
cancel_order	Cancels an order that has not been fulfilled.
update_order_note	Adds or updates the internal staff note on an order.

Install the Shopify Orders and Fulfillment MCP server

Complete the following steps to install a prebuilt MCP server to your project:

1

Sign in to your Workato account.

2

Go to AI Hub > MCP servers.

3

Click + Create MCP server.

4

Go to the Start with a template section and select the prebuilt MCP server you plan to use.

5

Click Use this template.

6

Provide a name for your MCP server in the MCP server name field.

7

Go to the Connections section and connect to your app account.

8

Select the connection type you plan to use for the MCP server template.

• User's connection: MCP server tools perform actions based on the identity and permissions of the user who connects to the application. Users authenticate with their own credentials to execute the skill.
• Your connection: This option uses the connection established by the recipe builder and follows the same principles as normal app connections.

Select your connection type

VERIFIED USER ACCESS AUTHENTICATION REQUIREMENTS

Only app connections that use OAuth 2.0 authorization code grant are available for user's connection. Refer to Verified user access for more information.

9

Complete the app-specific connection setup steps in the following section.

Shopify connection setup

You must have a Shopify Partner account to connect to Shopify in Workato. Workato supports the following connections types for Shopify:

• OAuth 2.0 authentication
• Access token authentication

OAuth 2.0 authentication

You must complete the following configurations to use OAuth 2.0 authentication:

• Create an OAuth profile
• Complete setup in Workato

Create an OAuth profile

Workato requires a custom OAuth profile to connect to Shopify using OAuth 2.0. Complete the following steps to create a custom OAuth 2.0 profile:

1

Sign in to the Shopify Dev Dashboard (opens new window) with a Partner account.

2

Click Create app.

3

Provide a name for your app in the Start from Dev Dashboard section, then click Create.

4

Enter the following URL in the App URL field:

https://www.workato.com

5

Enter the following URL in the Redirect URLs field:

https://www.workato.com/oauth/callback

6

Go to Settings.

7

Copy the Client ID and Secret and store these values in a secure location.

Copy the Client ID and Secret

8

Go to Home.

9

Click Install app.

Click Install app.

10

Select the store where you plan to install the app, then click Install.

11

Open Workato and go to Tools > Custom OAuth profiles.

12

Click + New custom profile.

13

Use the Application drop-down menu to select Shopify.

Select Shopify

14

Provide a Name for the account.

15

Click Create new app.

16

Enter the Client ID and Client secret from Shopify.

17

Click Done.

The custom OAuth profile is successfully configured. Refer to Complete setup in Workato to perform the remaining connection steps or to the Shopify OAuth apps (opens new window) documentation for more information.

PUBLISHED PUBLIC CUSTOM APPS REQUIRE APPROVAL TO ACCESS CUSTOMER PROTECTED DATA

Version 2022-10 and later releases require published public custom apps to satisfy Shopify's data protection policy (opens new window) to process customer data. You must have approval (opens new window) to access customer protected data if you are connecting through a published public custom app.

This requirement doesn't apply if you connect through custom apps using access token authentication or unpublished custom apps.

Complete setup in Workato

Complete the following steps to connect to Shopify in Workato using OAuth 2.0 authentication:

1

Click Create > Connection.

2

Search for and select Shopify on the New connection page.

3

Enter a name for your connection in the Connection name field.

4

Use the Location drop-down menu to select the project where you plan to store the connection.

5

Use the Authentication type drop-down menu to select OAuth 2.0.

6

Enter the Shop Name. You can find this value in the URL for your Shopify account. For example, the shop name is shopname if the URL is shopname.myshopify.com/admin.

7

Optional. Use the Requested permissions (OAuth scopes) drop-down menu to select the permissions to request for this connection. Refer to the Permissions section for more information.

8

Select the Custom OAuth profile to use for the connection. Refer to Create an OAuth profile for more information.

9

Click Connect and sign in to Shopify if prompted.

10

Click Install to complete the connection.

Permissions

Workato requests the following scopes by default when setting up a connection to Shopify:

• read_customers
• write_customers
• read_inventory
• write_inventory
• read_products
• write_products
• read_orders
• write_orders
• read_draft_orders
• write_draft_orders

You can grant Workato access to the following scopes in addition to the default scopes:

• write_reports
• read_reports
• write_payment_terms
• read_payment_terms
• read_product_listings
• read_assigned_fulfillment_orders
• write_assigned_fulfillment_orders
• read_merchant_managed_fulfillment_orders
• write_merchant_managed_fulfillment_orders
• read_third_party_fulfillment_orders
• write_third_party_fulfillment_orders
• read_all_orders

MINIMUM REQUIRED SCOPE TO ESTABLISH CONNECTION

The minimum scope required to establish a connection is read_products.

Access token authentication

You must complete the following configurations to use access token authentication:

• Create a Shopify integration app.
• Optional. Create an OAuth profile.
• Complete setup in Workato.

Create a Shopify integration app

Complete the following steps to create a custom Shopify integration app:

1

Sign in to the Shopify Admin (opens new window) page with a Partner account.

2

Go to Settings > Apps and sales channels.

3

Click Develop apps > Create an app.

4

Enter an App name and select an App developer, then click Create app.

5

Click Configure Admin API scopes.

Click Configure Admin API scopes.

6

Select scopes to provide Workato and click Save.

MINIMUM SCOPES REQUIRED

Access token authentication requires at least the read_products permission to successfully connect Workato to Shopify.

The recommended set of scopes are:

• read_customers
• write_customers
• read_inventory
• write_inventory
• read_products
• write_products
• read_orders
• write_orders
• read_draft_orders
• write_draft_orders

7

Go to API credentials and click Install app.

8

Reveal and copy the Admin API access token, API key, and API secret key. Record the values in a secure location. You can only see the access token once in Shopify and Workato.

The custom app is successfully configured in Shopify. Refer to the Shopify Custom apps (opens new window) documentation for more information.

Refer to Create an OAuth profile to manage permissions and credentials using a custom profile, or to Complete setup in Workato to perform the remaining connection steps.

Create an access token OAuth profile

Optionally, complete the following steps to create a custom OAuth profile that manages permissions and credentials for your connection:

1

Open Workato and go to Tools > Custom OAuth profiles.

2

Click + New custom profile.

3

Use the Application drop-down menu to select Shopify.

Select Shopify

4

Provide a Name for the account.

5

Click Create new app.

6

Enter the Client ID and Client secret from Shopify.

7

Click Done.

The custom OAuth profile is successfully configured. Refer to Complete setup in Workato to perform the remaining connection steps.

Complete connection setup in Workato

Complete the following steps to connect to Shopify in Workato using access token authentication:

1

Click Create > Connection.

2

Search for and select Shopify on the New connection page.

3

Enter a name for your connection in the Connection name field.

4

Use the Location drop-down menu to select the project or folder where you plan to store the connection.

5

Use the Authentication type drop-down menu to select Access token.

6

Enter the Access token from Shopify.

7

Enter the Shop Name. You can find this value in the URL for your Shopify account. For example, if the URL is shopname.myshopify.com/admin, the shop name is shopname.

8

Optional. Select the Custom OAuth profile to use for the connection. Refer to Create an OAuth profile for more information.

9

Click Connect to complete the connection.

How to use Shopify Orders and Fulfillment MCP server tools

Refer to the following sections for detailed information on available tools:

get_order tool

The get_order tool retrieves complete details for a single order given an order identifier. Your LLM uses this tool to retrieve comprehensive order information including line items, shipping address, payment status, fulfillment status, and tracking information.

Try asking:

• Get the details for order #1234.
• Show me the complete information for order 5678.
• Look up order #9012 and tell me its status.
• What items are in order #3456?

search_orders tool

The search_orders tool searches orders matching the filter criteria you specify including customer email, fulfillment status, financial status, date range, and tags. Your LLM uses this tool to find orders matching specific criteria rather than looking up one specific order.

Try asking:

• Find all orders from [email protected].
• Show me paid but unfulfilled orders.
• Search for orders from last week.
• Find orders tagged 'wholesale'.

list_unfulfilled_orders tool

The list_unfulfilled_orders tool retrieves orders with unfulfilled or partially fulfilled status, optimized for fulfillment queue management. Your LLM uses this tool to retrieve orders that haven't shipped. Results are sorted by creation date in ascending order (oldest first) to support fulfillment workflows.

Try asking:

• What orders need to ship?
• Show me unfulfilled orders.
• What's in the fulfillment queue?
• What orders are pending shipment?

fulfill_order tool

The fulfill_order tool creates a fulfillment record for an order, marking items as shipped with tracking information. Your LLM uses this tool to mark orders as shipped and associate tracking numbers. This tool fulfills one location per call.

Try asking:

• Mark order #1234 as fulfilled with tracking number 1Z000000010123456789.
• Fulfill order #5678 and use UPS as the carrier.
• Ship order #9012 with FedEx tracking 773189420346.
• Mark order #3456 as shipped.

cancel_order tool

The cancel_order tool cancels an order that hasn't been fulfilled. Your LLM uses this tool to cancel orders with options for refunding to the original payment method, restocking inventory, and notifying the customer. This tool requires a cancellation reason for record-keeping.

Try asking:

• Cancel order #1234 and refund the customer.
• Cancel order #5678 due to customer request.
• Cancel this order and restock the inventory.
• Process a cancellation for order #9012 with a refund.

update_order_note tool

The update_order_note tool adds or updates the internal staff note on an order. Your LLM uses this tool to document customer interactions, special handling instructions, issue resolution, or internal communication. Notes are visible to staff in Shopify Admin but aren't visible to customers.

Try asking:

• Add a note to order #1234 about the customer's delivery request.
• Document on order #5678 that the customer called about shipping.
• Update the internal note for order #9012 with resolution details.
• Add a staff note to order #3456 for special handling.

Getting started

View and manage your MCP server tools in the Overview page Tools section. Tool management provides the following capabilities:

• Start tools
• Remove tools
• Edit tools
• Add tools
• Edit your LLM-facing MCP server description

TOOLS MUST BE STARTED

Your LLM can only access active tools in your MCP server connector.