Skip to content
MCP server

Tailwind Shades

Generate full Tailwind CSS palettes from any color, in the project's own format

Pricing
Open source
Platforms
CLI, vscode, Web
Runs
Locally or Remotely
Version
1.6.0
Listing updated
2 days ago

About Tailwind Shades

Tailwind Shades is an open-source MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://tailwindshades.bourhaouta.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tailwindshades": {
      "url": "https://tailwindshades.bourhaouta.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Free; no API key

Prices change. Check tailwindshades.bourhaouta.com before you buy.

Tailwind Shades 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 to Tailwind Shades

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory