# Tailwind Shades

> Tailwind Shades is an open-source MCP server for developer tools. Generate full Tailwind CSS palettes from any color, in the project's own format. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, vscode, Web, API
- **Website:** https://tailwindshades.bourhaouta.com
- **Repository:** https://github.com/bourhaouta/vscode-tailwindshades/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.bourhaouta/tailwindshades
- **Categories:** developer tools, design and media
- **Listing updated:** 2026-11-15

## About

Agents tend to guess Tailwind shades or add a single brand line instead of a palette. This server hands them a real 50 to 950 scale in OKLCH, where the color you supply stays exactly as given and the other shades follow Tailwind's own colors. It covers Tailwind v4, v3, v2 and v1.

The generate_palette tool accepts any CSS color and outputs code in the right shape, such as a v4 @theme block or a v3 config, plus the shades, the shade holding the input and the closest Tailwind color as structured data. Its output opens with a comment of readable class pairs that pass WCAG AA at 4.5:1, so a red brand gets bg-brand-600 text-white instead of a failing combination. Extra output modes cover runtime-picked colors and Shopify themes. find_closest_tailwind_color maps a color such as #db4d53 to red-500 and says whether the difference is visible.

It can run remotely with no key, or locally over stdio with npx, which keeps everything on your machine. All five tools are read-only. The same engine powers a VS Code extension, a CLI and the website.

## Features

- **Full palettes:** A 50 to 950 scale computed in OKLCH from one input color.
- **Version aware:** Targets Tailwind v4, v3, v2 and v1 with matching formats.
- **Readable pairs:** Comments list class combinations that pass WCAG AA.
- **Closest Tailwind color:** Maps any color to the nearest built-in shade and reports the distance.
- **Runtime color output:** Modes for colors chosen at runtime and for Shopify theme settings.
- **Remote or local:** Streamable HTTP with no key, or a local stdio package.

## Good for

- Add a brand color to a Tailwind theme with a proper scale
- Pick accessible button and badge classes for a brand color
- Find which built-in Tailwind color matches a hex value
- Generate per-tenant color variables for a white-label app
- Convert a palette between Tailwind versions

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http tailwindshades https://tailwindshades.bourhaouta.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://tailwindshades.bourhaouta.com/mcp
```

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

```json
{
  "mcpServers": {
    "tailwindshades": {
      "url": "https://tailwindshades.bourhaouta.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "tailwindshades": {
      "type": "http",
      "url": "https://tailwindshades.bourhaouta.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tailwindshades": {
      "serverUrl": "https://tailwindshades.bourhaouta.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tailwindshades": {
      "type": "http",
      "url": "https://tailwindshades.bourhaouta.com/mcp"
    }
  }
}
```

## Tools

- `generate_palette`: A full 50 to 950 palette from one color, ready to paste.
- `find_closest_tailwind_color`: The Tailwind shade that looks most like a color, with the distance and whether the difference is visible.

## FAQ

### Does the input color stay unchanged?

Yes. It is kept exactly and the other shades are derived around it.

### Which Tailwind versions work?

v4, v3, v2 and v1.

### Do I need a key?

No. The remote endpoint needs no API key, and the local package runs with npx on Node.js 20 or later.

### Are the tools read-only?

Yes, all five are read-only.

### Is Tailwind Shades free?

Yes. Tailwind Shades is open source, so you can use and self-host it for free.

### How do I add Tailwind Shades to Claude Code?

Run this command in your terminal: claude mcp add --transport http tailwindshades https://tailwindshades.bourhaouta.com/mcp

### What are the best alternatives to Tailwind Shades?

The closest alternatives to Tailwind Shades 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/tailwind-shades
