io.github.nazariinalyvaikobs/shopify-store-builder-mcp
MCP server for building Shopify stores via the Admin GraphQL API: themes, pages, and navigation
Open source Open in the app JSON README (API)
About
MCP server for building Shopify stores via the Admin GraphQL API: themes, pages, and navigation
Details
- Kind
- MCP servers
- Topic
- Developer tools
- Publisher
- nazariinalyvaikobs
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.1
- Stars
- 3
- Last push
- 2026-08-12T13:49:26Z
- Repository state
- ativo
- Language
- TypeScript
- Added
- 2026-08-29 04:00:52
- Updated
- 2026-08-29 04:00:52
- Origin id
io.github.nazariinalyvaikobs/shopify-store-builder-mcp
README
# shopify-store-builder-mcp
MCP server for building Shopify stores with AI. Gives Claude Code, Cursor, and other MCP clients tools to edit themes, pages, and navigation on one Shopify store via the Admin GraphQL API.
Credentials stay on your machine. The server runs locally and talks directly to Shopify.
## Demo
https://github.com/user-attachments/assets/afd71d46-e8d7-4c06-96dc-094cae3fe5a2
## Quick start
https://github.com/user-attachments/assets/175e5051-b6ec-4201-a33e-d27c68356171
```bash
npx -y shopify-store-builder-mcp init
```
The wizard asks for your store credentials, verifies the connection, and registers the server in the client you pick:
- Claude Code
- Codex CLI
- Gemini CLI
- Claude Desktop
- Cursor
- Windsurf
- VS Code (Copilot)
Pick "Other" to print a config entry for any other MCP client.
## Getting Shopify credentials
You need a store on a plan with Admin API access and one of:
**Option A: Dev Dashboard app (recommended, tokens auto-refresh)**
1. Go to [dev.shopify.com/dashboard](https://dev.shopify.com/dashboard) and create an app for your store.
2. Grant it the scopes: `read_themes`, `write_themes`, `read_content`, `write_content`, `read_online_store_navigation`, `write_online_store_navigation`.
3. Copy the Client ID and Client Secret from the app's settings.
**Option B: permanent admin access token**
Use an existing `shpat_…` token from a custom app in your store admin (Settings → Apps and sales channels → Develop apps).
## Manual configuration
If you skip the wizard, add this to your MCP client's config:
```json
{
"shopify-builder": {
"command": "npx",
"args": ["-y", "shopify-store-builder-mcp"],
"env": {
"SHOPIFY_STORE_DOMAIN": "your-store.myshopify.com",
"SHOPIFY_CLIENT_ID": "…",
"SHOPIFY_CLIENT_SECRET": "…"
}
}
}
```
Or with a permanent token, replace the client credentials with `"SHOPIFY_ADMIN_ACCESS_TOKEN": "shpat_…"`.
## Tools
| Tool | What it does |
|------|--------------|
| `shop_get_info` | Read store name, domain, plan, currency |
| `theme_list` | List installed themes |
| `theme_read_file` | Read a theme file (Liquid, JSON, CSS, JS) |
| `theme_update_file` | Create or update a theme file |
| `page_list` | List store pages |
| `page_create` | Create a page |
| `page_update` | Update a page's title, body, or visibility |
| `menu_list` | List navigation menus |
| `menu_update` | Update a navigation menu |
## Development
```bash
npm install
npm run dev # run from source
npm run build # compile to dist/
npm test
```
## License
ISC