Coolors MCP
Color tools for AI agents: contrast fixes, Material 3 themes, palettes and CSS matching
- Pricing
- Open source
- Platforms
- CLI
- Runs
- Locally
- Version
- 2.0.0
- Listing updated
- 2 days ago
About Coolors MCP
Coolors MCP is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.
A model cannot see a hex code. Coolors MCP supplies 31 read-only tools that describe a color, check contrast and build palettes. describe_color returns a name, temperature, lightness, OKLCH, HCT, HSL and RGB values, the best text color and likely UI roles; fix_contrast finds the closest same-hue color that meets AA, AAA, UI or APCA targets.
It uses Google's HCT color space for Material Design 3 schemes and tonal palettes, simulates seven color-vision deficiencies, and extracts dominant colors from images. It can also map hard-coded CSS colors to a theme's custom properties and rewrite a stylesheet, export tokens to CSS, SCSS, Tailwind or W3C format, and audit the color tokens in a DESIGN.md file.
It runs locally over stdio with Node.js 20 or newer, no API keys and no network requests.
Install
Run in a terminal
claude mcp add coolors-mcp -- npx -y @trishchuk/coolors-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"coolors-mcp": {
"command": "npx",
"args": [
"-y",
"@trishchuk/coolors-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"coolors-mcp": {
"command": "npx",
"args": [
"-y",
"@trishchuk/coolors-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"coolors-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@trishchuk/coolors-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"coolors-mcp": {
"command": "npx",
"args": [
"-y",
"@trishchuk/coolors-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"coolors-mcp": {
"command": "npx",
"args": [
"-y",
"@trishchuk/coolors-mcp"
]
}
}
}Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- describe_color
- Describes a color with names, values and best text color.
- check_contrast
- Shows WCAG ratio and APCA Lc side by side.
- fix_contrast
- Finds the closest same-hue color meeting a target.
- audit_ui_colors
- Audits UI colors for contrast problems.
What it does
- Color description
- Names, values and best text color for any hex.
- Contrast fixes
- WCAG 2.x and APCA with same-hue corrections.
- Material 3 on HCT
- Light and dark schemes and tonal palettes.
- Color-blindness checks
- Seven simulations and palette collision audits.
- CSS theme matching
- Rewrite stylesheets onto custom properties.
- DESIGN.md audits
- Check contrast, duplicates and broken references.
Good for
- Pick readable text for a brand color
- Generate light and dark UI palettes
- Make chart colors color-blind safe
- Refactor hard-coded CSS colors into variables
Pricing
Open source
Runs locally, no API keys
Prices change. Check x51xxx.github.io before you buy.
Coolors MCP FAQ
Does it need API keys?
No; all 31 tools run locally.
What does it require?
Node.js 20 or newer.
How do I add it to Claude Code?
claude mcp add coolors -- npx -y @trishchuk/coolors-mcp
Which export formats?
CSS custom properties, SCSS, Tailwind config, W3C design tokens, JSON or a DESIGN.md colors block.
Is Coolors MCP free?
Yes. Coolors MCP is open source, so you can use and self-host it for free.
How do I add Coolors MCP to Claude Code?
Run this command in your terminal: claude mcp add coolors-mcp -- npx -y @trishchuk/coolors-mcp
What are the best alternatives to Coolors MCP?
The closest alternatives to Coolors MCP are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.
Alternatives to Coolors MCP

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory