# Coolors MCP

> Coolors MCP is an open-source MCP server for design and media. Color tools for AI agents: contrast fixes, Material 3 themes, palettes and CSS matching. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://x51xxx.github.io/coolors-mcp/
- **Repository:** https://github.com/x51xxx/coolors-mcp
- **MCP Registry name:** io.github.x51xxx/coolors-mcp
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add coolors-mcp -- npx -y @trishchuk/coolors-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "coolors-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@trishchuk/coolors-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "coolors-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@trishchuk/coolors-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "coolors-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@trishchuk/coolors-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "coolors-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@trishchuk/coolors-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "coolors-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@trishchuk/coolors-mcp"
      ]
    }
  }
}
```

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/coolors-mcp
