Newshopify MCP Server

🚀 Shopify Admin GraphQL MCP Server

A comprehensive Model Context Protocol (MCP) server for interacting with Shopify's Admin GraphQL API. This server provides tools and resources for managing products, orders, customers, inventory, discounts, metafields, and store information.

🚀 Quick Start

This is a comprehensive Model Context Protocol (MCP) server designed to interact with Shopify's Admin GraphQL API. It offers a range of tools and resources to streamline the management of various aspects of a Shopify store, including products, orders, customers, inventory, discounts, metafields, and store information.

✨ Features

• Comprehensive coverage of key Shopify Admin API functionalities.
• Structured tools for all major Shopify resources.
• Documented resources for each API section.
• Easy to use with any MCP-compatible client.

📦 Installation

1. Clone this repository.
2. Install the dependencies:

   npm install
   

3. Create a .env file with your Shopify credentials:

   SHOPIFY_SHOP_NAME=your-shop-name
   SHOPIFY_ACCESS_TOKEN=your-access-token
   

💻 Usage Examples

Basic Usage

Start the server:

npm run dev

Test using the MCP inspector:

npm run inspect

Advanced Usage

The server provides a variety of tools for different Shopify resources. Here are some examples:

Products

• getProduct: Retrieve a product by ID.
• listProducts: List products with pagination support.
• createProduct: Create a new product.
• updateProduct: Update an existing product.
• deleteProduct: Delete a product.

Orders

• getOrder: Retrieve an order by ID.
• listOrders: List orders with pagination support.
• cancelOrder: Cancel an order.

Customers

• getCustomer: Retrieve a customer by ID.
• listCustomers: List customers with pagination support.
• createCustomer: Create a new customer.
• updateCustomer: Update an existing customer.
• deleteCustomer: Delete a customer.

Inventory

• getInventoryItem: Retrieve an inventory item by ID.
• adjustInventory: Adjust the inventory level.
• getInventoryLevel: Get the inventory level for a location and item.

Discounts

• getDiscount: Retrieve a discount by ID.
• createDiscount: Create a basic discount code.
• deleteDiscount: Delete a discount.

Metafields

• getMetafield: Retrieve a metafield by ID.
• createProductMetafield: Create a metafield for a product.
• deleteMetafield: Delete a metafield.

Shop

• getShopInfo: Get information about your store.
• updateShopInfo: Update the store information.

📚 Documentation

Access the documentation resources at shopify://docs/{section}, where the section can be:

• overview
• products
• orders
• customers
• inventory
• discounts
• metafields
• shop

🔧 Technical Details

This server requires a Shopify Admin API access token. You can create one under Apps > Develop Apps in the Shopify Admin interface.