Shopify Chatbot
Agentic Shopify Chatbot with MCP integration, embedded directly into Shopify via a Theme Extension
What is Shopify Chatbot?
Shopify Chatbot is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to agentic shopify chatbot with mcp integration, embedded directly into shopify via a theme extension
Agentic Shopify Chatbot with MCP integration, embedded directly into Shopify via a Theme Extension
This server falls under the Business Applications category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Agentic Shopify Chatbot with MCP integration, embedded direc
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx chatbot-shopifyConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Shopify Chatbot
The Shopify Chatbot MCP server is an agentic AI chatbot system that integrates directly into Shopify stores as a Theme Extension, powered by OpenAI, RAG-based product search (FAISS + Elasticsearch), and an MCP backend for tool orchestration. It handles customer inquiries about products, manages cart operations, tracks orders, and authenticates customers — all within the Shopify storefront. Merchants and developers use it to provide intelligent, context-aware customer support that goes beyond scripted FAQ bots by combining real-time Shopify API data with semantic product search.
Prerequisites
- Docker and Docker Compose installed
- A Shopify store with Partner/Admin access to install a Theme Extension
- Shopify API credentials: SHOPIFY_API_KEY, SHOPIFY_API_SECRET, and SHOPIFY_STORE_URL
- An OpenAI API key (OPENAI_API_KEY) for LLM-powered responses
- MongoDB and Redis instances (included in the Docker Compose setup)
Clone the repository
Clone the project to your local machine and navigate into the directory.
git clone https://github.com/Mobeen-Dev/chatbot_Shopify.git
cd chatbot_ShopifyCreate and populate the .env file
Create a .env file in the project root with your Shopify, OpenAI, and infrastructure credentials. All values are required for the system to function correctly.
# .env
OPENAI_API_KEY=sk-your-openai-key
SHOPIFY_API_KEY=your-shopify-api-key
SHOPIFY_API_SECRET=your-shopify-api-secret
SHOPIFY_STORE_URL=https://your-store.myshopify.com
MONGODB_URI=mongodb://mongo:27017/shopify_chatbot
REDIS_URL=redis://redis:6379
ELASTICSEARCH_URL=http://elasticsearch:9200
FAISS_INDEX_PATH=/app/data/faiss.index
APP_ENV=development
LOG_LEVEL=infoBuild and start the services
Use Docker Compose to build all service images and start the full stack including the chatbot API, MongoDB, Redis, and Elasticsearch.
docker-compose build && docker-compose upInstall the Shopify Theme Extension
Follow the repository instructions to install the chatbot as a Shopify Theme Extension in your store. This embeds the chat widget into your storefront pages so customers can interact with the AI assistant.
Test the chatbot API endpoint
Verify the chatbot is working by sending a test request to the API endpoint with a sample customer query.
curl -X POST http://localhost:8000/api/test-chat \
-H 'Content-Type: application/json' \
-d '{"message": "Show me blue dresses under $100", "session_id": "test-session-001"}'Shopify Chatbot Examples
Client configuration
The Shopify Chatbot runs as a Docker-based service rather than a stdio MCP server. This shows how to reference it if integrating with a local MCP client for development purposes.
{
"mcpServers": {
"shopify-chatbot": {
"command": "docker-compose",
"args": ["up"],
"env": {
"OPENAI_API_KEY": "sk-your-openai-key",
"SHOPIFY_API_KEY": "your-shopify-api-key",
"SHOPIFY_API_SECRET": "your-shopify-api-secret",
"SHOPIFY_STORE_URL": "https://your-store.myshopify.com"
}
}
}
}Prompts to try
Sample customer queries the chatbot can handle once deployed in a Shopify storefront.
- "Show me blue dresses under $100"
- "What's the status of my order #1234?"
- "Add the red sneakers in size 10 to my cart"
- "Can I return a product I bought last week?"
- "Do you have this jacket in a large?"Troubleshooting Shopify Chatbot
Docker Compose fails to start with connection errors to MongoDB or Redis
Ensure all services are defined in docker-compose.yml and that the service names match the hostnames in your .env (e.g., MONGODB_URI=mongodb://mongo:27017). Run `docker-compose ps` to check which services started successfully and `docker-compose logs <service>` for details.
Chatbot returns generic responses and doesn't find products
The FAISS index and Elasticsearch must be populated with your Shopify product catalog before semantic search works. Check the repository for indexing scripts or seed commands to load your product data into the search backends.
Shopify API calls fail with 401 Unauthorized
Verify that SHOPIFY_API_KEY, SHOPIFY_API_SECRET, and SHOPIFY_STORE_URL are all set correctly in your .env file. The store URL should be in the format https://your-store.myshopify.com without a trailing slash. Confirm the API credentials have the required scopes (read_products, read_orders, write_checkouts) in your Shopify Partner dashboard.
Frequently Asked Questions about Shopify Chatbot
What is Shopify Chatbot?
Shopify Chatbot is a Model Context Protocol (MCP) server that agentic shopify chatbot with mcp integration, embedded directly into shopify via a theme extension It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Shopify Chatbot?
Follow the installation instructions on the Shopify Chatbot GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Shopify Chatbot?
Shopify Chatbot works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Shopify Chatbot free to use?
Yes, Shopify Chatbot is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Shopify Chatbot Alternatives — Similar Business Applications Servers
Looking for alternatives to Shopify Chatbot? Here are other popular business applications servers you can use with Claude, Cursor, and VS Code.
n8n
★ 189.1kA comprehensive MCP server that provides full control over n8n automation workflows through natural language. It offers 43 tools for managing workflows, executions, credentials, and data tables, with safety features like write-mode protection and dou
LobeHub
★ 77.5k🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.
Jeecgboot
★ 46.4kAI 低代码平台，「低代码 + 零代码」双模式驱动：低代码一键生成前后端代码，零代码 5 分钟搭建系统，AI Skills 一句话画流程、设计表单、生成整套系统。内置 AI聊天、知识库、流程编排、MCP插件等，兼容主流大模型。引领「AI 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式，消除 Java 项目 80% 的重复工作，提效而不失灵活。
CowAgent
★ 44.7kCowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理，能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长，比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入，可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI，能处理文本、语音、图片和文件，可快速搭建个人AI助理和企业数字员工。
Minds Platform
★ 39.2kPlatform dedicated to building an open foundation for applied Artificial Intelligence, designed for people seeking production-ready AI systems they can truly control, extend and deploy anywhere.
Astrbot
★ 32.8kAI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨
Browse More Business Applications MCP Servers
Explore all business applications servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Shopify Chatbot in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Shopify Chatbot?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.