orange4-shopify-mcp-server 0.1.0

Add your description here

Shopify MCP Server

A Model Context Protocol (MCP) server to connect clients like Claude with Shopify store data. This server exposes tools for retrieving product and customer information from your Shopify store.

Tools

• get-product-list: Retrieve a list of products from your Shopify store
• get-customer-list: Retrieve a list of customers from your Shopify store
• More to come soon

Prerequisites

• Python 3.12 or higher
• A Shopify store with API access
• Shopify API credentials (API Key, Password, and Access Token)

Installation

1. Clone the repository:

git clone https://github.com/siddhantbajaj/shopify-mcp-server.git
cd shopify-mcp-server

2. Create and activate a virtual environment using uv:

uv venv
source .venv/bin/activate  # On Unix/MacOS
# or
.venv\Scripts\activate  # On Windows

3. Install the package:

uv pip install -e .

Configuration

1. Create a .env file in the root directory with your Shopify credentials:

SHOPIFY_SHOP_URL="your-store.myshopify.com"
SHOPIFY_API_KEY="your_api_key"
SHOPIFY_PASSWORD="your_api_password"
SHOPIFY_ACCESS_TOKEN="your_access_token"

Replace the placeholder values with your actual Shopify API credentials.

Usage

1. Start the MCP server:

python -m shopify_mcp_server.server

2. The server exposes two tools:

get-product-list

Retrieves a list of products from your Shopify store.

• Optional parameter: limit (default: 10) - Maximum number of products to return

get-customer-list

Retrieves a list of customers from your Shopify store.

• Optional parameter: limit (default: 10) - Maximum number of customers to return

Tool Response Format

Products

Products (showing X):

Title: Product Name
ID: 123456789
Product Type: Type
Vendor: Vendor Name
Status: active
Price: $XX.XX
---

Customers

Customers (showing X):

Name: John Doe
ID: 123456789
Email: [e-mail]
Orders Count: X
Total Spent: $XX.XX
---

Development

This project uses:

• MCP (Model Context Protocol) for building AI-powered tools
• Shopify Python API for Shopify integration
• UV for dependency management

Security

• Never commit your .env file to version control
• Keep your Shopify API credentials secure
• Use environment variables for sensitive information

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request