
Color Space MCP Server: Setup for Claude, Cursor and Other Apps
Lets Claude, Cursor and other assistants convert colors between 221 color spaces with tested math instead of guesses.
Color Space is a color conversion library that also ships an MCP server. Its tools convert a color between any two of 221 color spaces and check which display gamut holds it. They can also write CSS strings, shader code, LUT files and ICC profiles. It runs on your computer with no account or API key. The README says it exists because language models get color math wrong in the third decimal.
Good for
- Designers who need exact conversions to OKLCH, Display P3 or Lab
- Front-end developers who want CSS color strings and gamut checks
- Video and graphics people who need LUTs, ICC profiles or shader code
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install color-space MCP
Claude Code
- 1
Copy this prompt.
Add the color-space MCP server to Claude Code. Run this command: claude mcp add color-space -- npx -y color-space mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js.
Read-only mode: Every tool is read-only, so there is nothing to switch off.
The command ends in mcp, which starts the server. The plain color-space command on its own is a conversion tool for the terminal, not the MCP server. No account or key is needed.
From the project README. Source.
Tools
Converts a color, or a batch of colors, between any two spaces
Takes a color as a CSS string or channel values and returns it in another space, using that space's normal ranges. It flags channels that fall outside the target's range and does not clamp them. A batch of up to 1,024 colors works too.
Try: “Convert #ff8000 to OKLCH.”
Read ·
convertWrites a color as ready-to-paste CSS strings
Returns the color as CSS strings such as rgb(), hsl(), lab(), oklch() and color(display-p3 ...), plus a hex code when it fits sRGB. A string comes back empty where CSS would clamp the color into a different one.
Try: “Give me CSS strings for oklch(0.7 0.1 50), including Display P3.”
Read ·
cssChecks whether a color fits sRGB, Display P3 or Rec. 2020
Tests a color against sRGB, Display P3 and Rec. 2020 and reports the smallest one that holds it. It only checks membership and does not map the color into a smaller gamut.
Try: “Is color(display-p3 1 0.5 0) inside sRGB?”
Read ·
gamutExplains one color space: channels, ranges and sources
Returns the display name, description, channels with their usual ranges, defining references, year and author, illuminant and observer, and the spaces it converts to directly.
Try: “Tell me about the OKLCH color space and where it comes from.”
Read ·
spaceSearches the catalog of 221 color spaces
Lists the available color spaces and can filter by a search phrase, family or purpose, with the best matches first.
Try: “Which color spaces are used for camera log footage?”
Read ·
spacesBuilds a .cube LUT file for a conversion
Produces a .cube lookup table that works in Resolve, Premiere, Final Cut, OBS or ffmpeg. The header carries the measured deviation from the direct conversion, and the lattice size is limited to 33 here.
Try: “Make a .cube LUT that converts S-Log3 to Rec. 709.”
Read ·
cubeWrites a color conversion as GLSL, WGSL, HLSL or MSL code
Returns shader code for a conversion in GLSL, WGSL, HLSL or Metal, with an entry function named after the two spaces and every helper on the path. HLSL and MSL need the optional naga-wasm package installed next to it.
Try: “Write a GLSL function that converts RGB to OKLCH.”
Read ·
shaderExports a color space as an ICC profile
Returns one color space as an ICC v2 profile, encoded in base64. It uses a matrix and tone curve for RGB working spaces and a lookup table for others.
Try: “Export Display P3 as an ICC profile.”
Read ·
iccShows the library call for a conversion and a Python equivalent
Returns the color-space JavaScript call with its result and, where one exists, the matching colour-science Python code checked against color-space, with any known caveat.
Try: “Show me the code to convert sRGB 200, 100, 50 to CIELAB in JavaScript and Python.”
Read ·
code
Read from the source code
Permissions
low risk · 2 things to watch
Low risk
All nine tools are marked read-only and only return converted colors or generated files as text. No special precautions are needed.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
Out-of-range colors are not clamped
A converted color can fall outside the target space's range, and the result flags each channel instead of fixing it. Check the range flag before using a color in a design. github.com
HTTP mode listens on localhost
The optional HTTP mode binds to 127.0.0.1 by default. Leave it on that address unless you add your own protection. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | Every tool is marked read-only in the server source, so there is nothing to switch off. |
|---|---|
| Sign-in and keys | No credentials needed. |
Questions
Does Color Space MCP need an API key?
No. It runs on your computer with no account, sign-in or API key. The npm package is CC0 licensed, which means public domain.
What color formats can I give it?
Any CSS color string such as #ff8000, rebeccapurple, oklch(0.7 0.1 50) or color(display-p3 1 0.5 0), or channel values with a space name.
Why use it instead of asking the AI to convert colors?
The project says models produce plausible but slightly wrong matrices. The server calls the library, which tests each conversion against a cited reference, so the numbers are computed, not guessed.
Is it the same as the color-space npm library?
It is part of it. The package is a color conversion library, and the MCP server is one command of it. The page you are reading covers only the MCP server.
Can it run in Docker or over HTTP?
Yes to both. The README documents building a Docker image and a localhost HTTP mode. The install box above uses the simpler npx command.
Is there a Claude Code plugin?
Yes. The README gives a plugin that adds the server plus a skill, installed from the project's marketplace.
Information
updated Nov 2, 2026
- Publisher
- Community
- Package
color-space- Registry
- npm
- Transport
- stdio, Streamable HTTP
- Auth
- None
- Version
- 3.5.0
- License
- CC0-1.0
- Last commit
- Oct 29, 2026
- Open issues
- 0
- Listed in
- Official MCP registry
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 2Hide
- color-space README, Agents section · github.com
- color-space MCP server source · github.com