Migrate from Shopify to Medusa with One Prompt

We added a new migration tool to the Medusa MCP server. You can now prompt your AI agent to migrate store data from Shopify directly into Medusa.

By default, the tool migrates the following data types for you:

• Products, variants, prices, and images
• Inventory levels
• Collections and categories

Its instructions can also be extended to migrate other data types, such as orders and customers.

Why move from Shopify to Medusa

Shopify is a great tool for simpler commerce operations, but it often has limited customization options. Many users have complained that in order to solve unique business use cases, you often need to resort to hacky workarounds and third-party apps. This increases your Shopify costs on top of the platform fees, extra transaction costs, and GMV taxes.

If you're struggling with these issues, Medusa is the answer to your problem:

• Extensibility: Medusa is an ecommerce platform with a Framework built for customization and flexibility. Customize existing core features and build your custom business logic without limits.
• AI-native Platform: Medusa's open source nature and AI toolkit (MCP server, skills, AI-friendly CLI) support your AI development workflows to build and manage your store.
• Cheaper setup: Host on Medusa Cloud at a tenth of the cost of Shopify Plus. Medusa Cloud has lower platform fees, no extra transaction costs or GMV tax, and no pricey third-party plugins, as you can build them into Medusa instead.

Why add a migration tool

If you're running your store on Shopify and you want to migrate to Medusa, you'll run into pitfalls handling source data and matching it into what Medusa expects.

This is more the case if you're using add-ons or extensions in Shopify that you or your AI agent can't decide on the best way to map into Medusa.

To make this process easier for you, our team has built prompts into the Medusa Cloud MCP server that provide your AI agent with a full migration plan. It includes caveats and common pitfalls to look out for, while allowing the agent to adapt to your custom use case.

What the migration tool does

When you describe what you want to migrate to an AI agent connected to the Medusa Cloud MCP server, it calls the migration tool and receives a complete, ordered implementation guide tailored for the data types you want to migrate.

The MCP server provides support for two migration approaches:

1. Custom approach: Pulls data from Shopify's API. The import is idempotent and resumable, so it can be triggered on a schedule, from an admin page, via a CLI command, or other custom approaches. This migration also covers inventory and images, and you can ask your agent to handle your custom extensions.
2. CSV approach: transforms your Shopify product export file into the format Medusa's built-in product importer accepts. Use this for a fast, one-time cutover when you can't create a Shopify app. It doesn't migrate inventory quantities, and images remain as URLs pointing to the old CDN.

What the agent does with the tool

After calling the MCP server to get the migration plan, your agent:

1. Asks which approach you want if you haven't specified one
2. Builds the flows and customizations needed, or helps you prepare a CSV file for import, based on the approach you choose
3. Guides you through running the import and verifying migrated data

By the end of the prompt, you can import your catalog data from your source platform into Medusa.

Get started

Before you get started, you must create a Medusa Cloud organization to connect to the MCP server. It's also recommended to create a Medusa project that will hold your migrated data.

Then, in your AI agent, connect to the Medusa MCP server and prompt your agent with something like:

12
Migrate my Shopify store's products to Medusa.

Full details on supported platforms and data types are in the migration tool documentation.