https://github.com/rushikeshmore/admin-agent
AI-powered Shopify Admin via Claude + MCP. 21 tools: products, collections, ShopifyQL analytics, bulk operations. Full store management through conversation.
https://github.com/rushikeshmore/admin-agent
admin-api ai claude graphql mcp mcp-server python shopify shopify-admin shopify-api
Last synced: 28 days ago
JSON representation
AI-powered Shopify Admin via Claude + MCP. 21 tools: products, collections, ShopifyQL analytics, bulk operations. Full store management through conversation.
- Host: GitHub
- URL: https://github.com/rushikeshmore/admin-agent
- Owner: rushikeshmore
- Created: 2026-03-18T13:56:15.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-18T16:55:04.000Z (4 months ago)
- Last Synced: 2026-03-19T04:56:22.809Z (4 months ago)
- Topics: admin-api, ai, claude, graphql, mcp, mcp-server, python, shopify, shopify-admin, shopify-api
- Language: Python
- Homepage: https://agentkarma.dev
- Size: 85.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AdminAgent
AI-powered Shopify Admin via Claude + MCP. Manage your entire store through conversation.
## What It Does
21 MCP tools that give Claude full control over products, collections, analytics, and bulk operations in your Shopify store.
| Domain | Tools | Examples |
|--------|-------|---------|
| Products | 11 | List, create, update, delete, duplicate, manage variants/options |
| Collections | 6 | List, create, update, delete, add/remove products |
| Analytics | 1 | Run any ShopifyQL query (revenue, orders, sessions, products) |
| Bulk Ops | 3 | Submit bulk queries, check status, cancel |
## Setup
1. **Create a custom app** in your Shopify admin (Settings → Apps → Develop apps)
2. **Grant API scopes:** `read_products`, `write_products`, `read_reports`
3. **Install the app** and copy the Admin API access token
```bash
# Clone and install
cd /path/to/admin-agent
python3.12 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
# Configure
cp .env.example .env
# Edit .env: set SHOPIFY_STORE and SHOPIFY_ACCESS_TOKEN
# Register with Claude Code
claude mcp add admin-agent .venv/bin/python server.py
```
## Usage
```
"List all active products"
"Create a product called 'Summer Tee' priced at $29.99"
"Show me revenue by product type for the last 90 days"
"Export all products via bulk query"
```
## Stack
Python 3.12 · FastMCP · Shopify Admin GraphQL API (2026-04) · httpx
## Safety
Every tool is classified by destructiveness:
- **Read** (Tier 0): No confirmation needed
- **Write** (Tier 1): Preview changes before executing
- **Destructive** (Tier 2): Explicit confirmation required
- **Bulk** (Tier 3): Count + preview + confirm
Dangerous operations (payments, domains, checkout, tax) are intentionally excluded.