Huebook
Sculpted Apps
All guides
Huebook / Guide

MCP and AI agents

Model Context Protocol (MCP) lets a compatible agent connect to Huebook while it is running.

Model Context Protocol (MCP) lets a compatible agent connect to Huebook while it is running. On Mac, open Settings → MCP, turn on Enable MCP server, and copy the endpoint. This is a Huebook Pro feature. The server listens only on this Mac at http://127.0.0.1:9842/mcp and stops when Huebook quits.

Claude Code: run claude mcp add --transport http palette http://127.0.0.1:9842/mcp in Terminal. Then run claude mcp list or enter /mcp in Claude Code to check the connection.

Codex: run codex mcp add palette --url http://127.0.0.1:9842/mcp in Terminal. Run codex mcp list or /mcp in the Codex TUI to check the connection.

OpenCode: run opencode mcp add and follow the prompts to add a remote HTTP server named palette with the endpoint above. Or add this to opencode.json: "mcp": { "palette": { "type": "remote", "url": "http://127.0.0.1:9842/mcp", "enabled": true } }. Use opencode mcp list to check its status.

Ask your agent to list your saved palettes, inspect a palette or catalog colors, create a palette from color values, or change a favorite. Huebook’s MCP tools cannot edit or delete existing records, import images, or use the screen picker. Huebook must stay open, and the agent must run on the same Mac because the endpoint is local-only.

Claude Code ↗ · Codex ↗ · OpenCode ↗

Need a hand?

Tell us what you were doing, your device, and your Huebook version.

Contact us ↗