jake/squarespace-mcp-2026-complete

Jake Shore 6985b092a5 Rebrand to MCPEngage and customize Squarespace README with e-commerce/website power moves

2026-02-02 06:58:51 -05:00

7.4 KiB

Raw Permalink Blame History

🚀 Don't want to self-host? Join the waitlist for our fully managed solution →

Zero setup. Zero maintenance. Just connect and automate.

🚀 Squarespace MCP Server — 2026 Complete Version

💡 What This Unlocks

This MCP server gives AI direct access to your Squarespace Commerce and website platform. Instead of manually managing products, orders, pages, and inventory through the Squarespace interface, you just tell the AI what you need — in plain English.

🎯 E-Commerce & Website Power Moves

The AI can directly control your Squarespace site with natural language:

Inventory Sync — "Check inventory levels across all products and flag any with less than 5 units remaining"
Order Processing — "Show me all pending orders from the last week and their fulfillment status"
Product Catalog — "List all digital products and their current prices"
Content Management — "Get all published pages and show me their last modified dates"
Stock Updates — "Update inventory for product variant XYZ to 100 units and set it to unlimited stock"

🔗 The Real Power: Combining Tools

AI can chain multiple Squarespace operations together in one conversation:

Query low-stock products → Generate restock list → Update inventory levels
Pull order data → Match customer info → Export fulfillment queue
Analyze page content → Cross-reference products → Generate marketing content
List all orders → Filter by status → Create fulfillment workflow

📦 What's Inside

8 powerful API tools covering Squarespace Commerce and website management:

list_pages — Browse website pages with pagination
get_page — Get specific page details and content
list_products — Query product catalog with filters
get_product — Get complete product details
list_orders — Browse orders with status filters
get_order — Get full order details
list_inventory — Check stock levels for all variants
update_inventory — Adjust product inventory levels

All with proper error handling, automatic authentication, and TypeScript types.

🚀 Quick Start

Option 1: Claude Desktop (Local)

Clone and build:

git clone https://github.com/BusyBee3333/Squarespace-MCP-2026-Complete.git
cd squarespace-mcp-2026-complete
npm install
npm run build

Get your Squarespace API key:
- Log in to your Squarespace account
- Go to Settings → Advanced → API Keys
- Click Generate Key (requires Commerce Advanced plan or Developer mode)
- Copy your API key securely

Configure Claude Desktop:

On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

On Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "squarespace": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/squarespace-mcp-2026-complete/dist/index.js"],
      "env": {
        "SQUARESPACE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Restart Claude Desktop

Option 2: Deploy to Railway

Click the button above
Set your Squarespace API key in Railway dashboard
Use the Railway URL as your MCP server endpoint

Option 3: Docker

docker build -t squarespace-mcp .
docker run -p 3000:3000 \
  -e SQUARESPACE_API_KEY=your-key \
  squarespace-mcp

🔐 Authentication

Squarespace uses Bearer Token (OAuth2) authentication with API Keys.

Setup Steps:

In Squarespace admin: Settings → Advanced → API Keys
Click Generate Key (requires Commerce Advanced or Developer plan)
Select scopes:
- Website Content: Read (for pages)
- Commerce: Read & Write (for products, orders, inventory)
Copy and save your API key securely (shown only once!)

API Documentation: https://developers.squarespace.com/commerce-apis

Note: API access requires:

Commerce Advanced plan or higher
Developer mode enabled (for some features)

The MCP server handles all API requests automatically using your API key.

🎯 Example Prompts

Once connected to Claude, you can use natural language for e-commerce and website operations:

Inventory Management:

"Show me all products with inventory below 10 units"
"Update inventory for variant ID abc123 to 75 units"
"List all products with unlimited inventory enabled"

Order Management:

"Get all orders from the last 7 days"
"Show me pending orders that need fulfillment"
"Get complete details for order #12345 including line items"

Product Catalog:

"List all physical products currently in the catalog"
"Show me digital products with prices over $50"
"Get product details for item SKU 'SUMMER-2024'"

Website Content:

"List all published pages on the site"
"Get the content and metadata for the 'About' page"
"Show me pages modified in the last month"

Combined Operations:

"Generate a report of all low-stock items and their current inventory"
"List orders from this week and show which products are most popular"
"Check all product variants and identify which need inventory updates"

🛠️ Development

Prerequisites

Node.js 18+
npm or yarn
Squarespace site with Commerce Advanced or Developer plan
API key with appropriate scopes

Setup

git clone https://github.com/BusyBee3333/Squarespace-MCP-2026-Complete.git
cd squarespace-mcp-2026-complete
npm install
cp .env.example .env
# Edit .env with your Squarespace API key
npm run build
npm start

Testing

npm test                  # Run all tests
npm run test:watch        # Watch mode
npm run test:coverage     # Coverage report

🐛 Troubleshooting

"Authentication failed"

Verify your API key is correct (check for copy/paste errors)
Ensure your API key hasn't expired or been revoked
Confirm you have the Commerce Advanced plan or Developer mode enabled

"Tools not appearing in Claude"

Restart Claude Desktop after updating config
Check that the path in claude_desktop_config.json is absolute (not relative)
Verify the build completed successfully (dist/index.js exists)

"403 Forbidden" errors

Check that your API key has the required scopes enabled
Some endpoints require specific plan levels (Commerce Advanced+)
Verify you're not hitting rate limits

📖 Resources

🤝 Contributing

Contributions are welcome! Please:

Fork the repo
Create a feature branch (git checkout -b feature/amazing-tool)
Commit your changes (git commit -m 'Add amazing tool')
Push to the branch (git push origin feature/amazing-tool)
Open a Pull Request

📄 License

MIT License - see LICENSE for details

🙏 Credits

Built by MCPEngage — AI infrastructure for business software.

Want more MCP servers? Check out our full catalog covering 30+ business platforms.

Questions? Open an issue or join our Discord community.

7.4 KiB Raw Permalink Blame History